.NET Core 3迁移至.NET 7后DateTime无UTC标识Z的原因

核心原因 #

.NET Core 3.x到.NET 5+（包括.NET7）期间，System.Text.Json的DateTime序列化逻辑发生了关键变更：

• 在.NET Core 3.x中，当DateTime的Kind属性为Unspecified（这是从SQL Server等数据库读取datetime/datetime2类型时的默认状态，因为这类数据库类型不存储时区信息），序列化器会默认将其当作UTC时间处理，最终输出带Z标识的ISO 8601格式字符串。
• 从.NET 5开始，为了更严格遵循ISO 8601规范，System.Text.Json不再默认假设Unspecified的DateTime是UTC，而是直接输出不带任何时区标识的字符串，这就是响应中丢失Z的原因。

解决办法 #

1. 改用DateTimeOffset类型（推荐） #

这是你已经尝试的方案，DateTimeOffset类型本身包含时区偏移信息，无论数据库读取的是何种时间，序列化时都会明确输出偏移量（UTC时间对应Z），同时能避免DateTime类型的时区歧义问题，是处理跨时区时间的最佳实践。只需将实体和DTO中的DateTime类型替换为DateTimeOffset即可，AutoMapper会自动完成映射。

2. 强制将Unspecified DateTime视为UTC序列化 #

如果不想修改类型，可以通过两种方式实现：

方式一：配置EF Core，读取时设置DateTime的Kind为Utc

在EF Core的实体配置中，指定属性转换逻辑，确保从数据库读取的DateTime被标记为UTC：

modelBuilder.Entity<Shipment>()
    .Property(s => s.Updated)
    .HasConversion(
        v => v, // 写入数据库时保持原样
        v => DateTime.SpecifyKind(v, DateTimeKind.Utc) // 读取时标记为UTC
    );

这样序列化时，因为DateTime的Kind是Utc，.NET7的System.Text.Json会自动添加Z标识。

方式二：自定义System.Text.Json转换器

在Startup/Program.cs中配置Json序列化选项，添加自定义转换器处理Unspecified的DateTime：

builder.Services.AddControllers()
    .AddJsonOptions(options =>
    {
        options.JsonSerializerOptions.Converters.Add(new UtcDateTimeConverter());
    });

// 自定义转换器
public class UtcDateTimeConverter : JsonConverter<DateTime>
{
    public override DateTime Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options)
    {
        var date = DateTime.Parse(reader.GetString());
        return DateTime.SpecifyKind(date, DateTimeKind.Utc);
    }

    public override void Write(Utf8JsonWriter writer, DateTime value, JsonSerializerOptions options)
    {
        var utcValue = value.Kind == DateTimeKind.Unspecified 
            ? DateTime.SpecifyKind(value, DateTimeKind.Utc) 
            : value.ToUniversalTime();
        writer.WriteStringValue(utcValue.ToString("yyyy-MM-dd'T'HH:mm:ss.fffffffZ"));
    }
}

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