.NET EF+PostgreSQL中UTC DateTime被自动转换为本地时间问题

问题根源 #

Npgsql 默认会将 PostgreSQL 中存储的 timestamptz（带时区时间）转换为本地时区的 DateTime（DateTimeKind.Local），而非保留 UTC 类型标识。这就导致读取后时间偏移错误，且更新实体时错误的本地时间会被写回数据库覆盖原 UTC 时间。

有效解决方案 #

1. 全局配置Npgsql读取DateTime时保留UTC类型 #

无需修改实体属性，通过连接字符串或DbContext配置全局设置读取的DateTime类型为UTC：

方式一：连接字符串添加参数

在数据库连接字符串中加入 DateTimeKind=Utc：

Host=your-host;Database=your-db;Username=user;Password=pass;DateTimeKind=Utc

方式二：DbContext配置中指定

在注册DbContext时，通过ConfigureDateTimeHandling设置默认读取为UTC：

services.AddDbContext<YourDbContext>(options =>
    options.UseNpgsql(
        configuration.GetConnectionString("DefaultConnection"),
        npgsqlOptions => npgsqlOptions.ConfigureDateTimeHandling(DateTimeKind.Utc)
    )
);

此配置会让Npgsql将读取的时间全部标记为DateTimeKind.Utc，不会自动转换为本地时区，更新时自然会以UTC格式写回数据库。

2. 正确使用DateTimeOffset（若已切换） #

如果已经将实体属性改为DateTimeOffset，需确保映射到PostgreSQL的timestamptz类型（默认已映射，但可显式确认）：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<SomeEntity>()
        .Property(e => e.CreatedAt)
        .HasColumnType("timestamptz"); // 显式指定列类型为带时区时间
}

DateTimeOffset本身会保留时区信息，读取和写入时不会丢失UTC标识，避免转换错误。

3. 正确配置NodaTime（若使用） #

使用NodaTime时，实体属性需替换为NodaTime的类型（如Instant），而非原DateTime：

// 实体类属性
public Instant CreatedAt { get; set; }

然后在DbContext中确保NodaTime配置生效，无需额外转换（UseNodaTime会自动处理映射）：

services.AddDbContext<YourDbContext>(options =>
    options.UseNpgsql(
        configuration.GetConnectionString("DefaultConnection"),
        x => x.UseNodaTime()
    )
);

Instant代表UTC时间戳，不会涉及时区转换，彻底避免本地时间问题。

为什么之前的方案未生效？ #

• 仅切换DateTime到DateTimeOffset但未确认列类型映射，可能仍使用timestamp（无时区）导致时区信息丢失；
• 使用UseNodaTime但实体仍保留DateTime属性，Npgsql不会自动适配NodaTime类型，仍按原有逻辑处理；
• SpecifyKind在保存前执行时，读取的时间已经被转换为本地类型，无法从根源解决全局读取转换问题。

内容的提问来源于stack exchange，提问作者Aamer