.NET 8 Web API升级后DateTime属性时区偏移异常问题咨询

问题分析 #

从.NET 7升级到.NET 8后，API返回的DateTime值被错误转换为服务器本地时区（+5:30）的时间（时间值额外增加5小时30分），但PostgreSQL数据库中存储的原始时间为2024-01-02 13:11:37.076752，.NET 7返回的是带时区偏移但时间值正确的结果。调试中直接序列化DateTime值显示正常，说明问题出在EF Core读取数据库时间的类型映射或响应序列化的最终处理环节。

核心原因：.NET 8中EF Core对PostgreSQL的timestamp without time zone类型默认映射行为发生变化，将读取的时间标记为DateTimeKind.Utc；而.NET 7中默认标记为DateTimeKind.Unspecified。当NewtonsoftJson配置DateTimeZoneHandling = Local时，会将UTC时间转换为本地时区时间（时间值叠加时区偏移），而非仅为无时区时间添加偏移标记。

解决方案 #

方案1：修正EF Core的DateTime类型映射 #

强制EF Core将PostgreSQL的timestamp without time zone类型读取为DateTimeKind.Unspecified，保持与.NET 7一致的行为：

全局配置（所有DateTime属性）

在DbContext的OnModelCreating方法中添加全局映射规则：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    // 全局配置：将所有映射到timestamp without time zone的DateTime属性标记为Unspecified
    foreach (var entityType in modelBuilder.Model.GetEntityTypes())
    {
        foreach (var property in entityType.GetProperties())
        {
            if (property.ClrType == typeof(DateTime) || property.ClrType == typeof(DateTime?))
            {
                var columnType = property.GetColumnType();
                if (columnType != null && columnType.Equals("timestamp without time zone", StringComparison.OrdinalIgnoreCase))
                {
                    // 处理非可空DateTime
                    property.SetValueConverter(new ValueConverter<DateTime, DateTime>(
                        v => v,
                        v => DateTime.SpecifyKind(v, DateTimeKind.Unspecified)
                    ));
                    // 处理可空DateTime?
                    if (property.ClrType == typeof(DateTime?))
                    {
                        property.SetValueConverter(new ValueConverter<DateTime?, DateTime?>(
                            v => v,
                            v => v.HasValue ? DateTime.SpecifyKind(v.Value, DateTimeKind.Unspecified) : null
                        ));
                    }
                }
            }
        }
    }

    // 其他实体配置逻辑...
}

单个实体属性配置

如果仅需针对特定属性调整，可单独配置：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<MyTable>()
        .Property(e => e.lastUpdatedOn)
        .HasColumnType("timestamp without time zone")
        .HasConversion(
            v => v,
            v => DateTime.SpecifyKind(v, DateTimeKind.Unspecified)
        );

    // 其他实体配置逻辑...
}

方案2：调整NewtonsoftJson序列化配置 #

如果不想修改EF Core映射，可调整序列化规则，让UTC时间仅添加本地时区偏移而不转换时间值：
将DateTimeZoneHandling改为UnspecifiedLocal，该设置会将Unspecified或UTC时间当作本地时间处理，仅添加时区偏移标记：

services.AddControllers().AddNewtonsoftJson(options =>
{
    options.SerializerSettings.DateTimeZoneHandling = Newtonsoft.Json.DateTimeZoneHandling.UnspecifiedLocal;
});

验证步骤 #

1. 调试时查看sh.lastUpdatedOn.Kind属性，确认其为Unspecified（方案1生效）。
2. 重新运行API，检查返回结果是否与.NET 7一致："2024-01-02T13:11:37.076752+05:30"。

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