Npgsql 中使用 NodaTime 类型映射的最佳实践

问题背景

在使用 Npgsql 连接 PostgreSQL 数据库时，开发者经常会遇到将 NodaTime 类型映射到 PostgreSQL 原生类型的问题。特别是当尝试将 NodaTime 的 Period 类型映射到 PostgreSQL 的 interval 类型时，可能会遇到"Writing values of 'NodaTime.Period' is not supported for parameters having NpgsqlDbType 'Interval'"这样的错误。

问题分析

这个问题的根源在于 Npgsql 的配置方式。Npgsql 提供了两个层次的配置：

1. 底层 Npgsql 驱动配置：负责处理基本的 ADO.NET 数据访问
2. EF Core 提供程序配置：负责 Entity Framework Core 集成

当使用 NpgsqlDataSourceBuilder 构建数据源时，NodaTime 支持需要在两个层次都进行配置。如果只配置了 EF Core 层而忽略了底层驱动配置，就会出现类型映射不支持的错误。

解决方案

正确的配置方式应该同时包含两个层次的 NodaTime 支持：

public static void AddInfrastructure(this IServiceCollection services)
{
    var dataSourceBuilder = new NpgsqlDataSourceBuilder("连接字符串");
    dataSourceBuilder.UseNodaTime(); // 底层 Npgsql 驱动配置
    
    var dataSource = dataSourceBuilder.Build();
    
    services.AddDbContext<MyDbContext>(options =>
        options.UseNpgsql(dataSource, ngOptions =>
        {
            ngOptions.UseNodaTime(); // EF Core 层配置
        }).UseSnakeCaseNamingConvention()
    );
}

技术细节

NodaTime 类型映射

NodaTime 提供了比 .NET 原生 DateTime 更丰富的时间处理功能，Npgsql 支持以下主要映射关系：

• Instant ↔ timestamp with time zone
• LocalDateTime ↔ timestamp without time zone
• LocalDate ↔ date
• LocalTime ↔ time
• Period ↔ interval
• Duration ↔ interval (但 Period 是更准确的映射)

为什么需要双重配置

1. 底层驱动配置：确保 ADO.NET 层面能正确处理 NodaTime 类型的序列化和反序列化
2. EF Core 配置：确保 Entity Framework 能正确生成迁移和查询转换

最佳实践

1. 始终在两个层次都配置 NodaTime 支持
2. 对于时间间隔，优先使用 Period 而非 Duration
3. 在 EF Core 实体配置中明确指定列类型：

builder.Property(e => e.Duration)
    .HasColumnType("interval");

4. 考虑使用 snake_case 命名约定保持数据库一致性

未来改进

Npgsql 团队正在开发 9.0 版本，计划简化这一配置过程。在新版本中，当使用简单的 DataSource 时，EF Core 配置将自动设置底层的 Npgsql 配置，减少重复工作。

总结

正确处理 NodaTime 类型映射需要理解 Npgsql 的双层架构。通过同时在数据源构建器和 EF Core 配置中启用 NodaTime 支持，可以确保类型映射在应用程序的所有层次都能正常工作。这种配置方式不仅适用于 Period 类型，也适用于 NodaTime 提供的其他时间相关类型。