部署至Azure时EF Core丢失DateTimeOffset特定偏移的原因及解决咨询

问题描述 #

.NET 8 API向Azure SQL数据库写入数据，表中CreatedOn字段为datetimeoffset(7)类型，用于存储带偏移的日期时间。该字段通过EF Core的OnBeforeSaving事件设置：

entry.Property("CreatedOn").CurrentValue = new DateTimeOffset(DateTime.Now);

本地环境写入时，EF Core生成带偏移的日期时间：2024-01-24 18:06:44.5682227 -05:00；部署至Azure环境后，生成的日期时间偏移为+00:00：2024-01-24 23:15:04.7942096 +00:00。当反序列化为.NET DateTimeOffset字段时，值变为2024-01-24 23:15:04.794209（毫秒精度丢失），导致日期时间比较失败。

原因分析 #

• 时区差异：本地服务器时区为UTC-5（如美国东部时间），而Azure App Service默认使用UTC时区。DateTime.Now获取的是服务器本地时间，在Azure环境下就是UTC时间，构造DateTimeOffset时会自动采用当前服务器时区偏移，因此生成+00:00的偏移值。
• 序列化精度丢失：默认的JSON序列化配置（比如System.Text.Json）对DateTimeOffset的输出可能截断最后一位小数，导致反序列化后精度不足，直接引发日期时间比较失败。

解决方案 #

1. 统一UTC时间与偏移 #

放弃使用DateTime.Now，改用DateTimeOffset.UtcNow直接生成UTC偏移的时间，彻底避免时区环境差异：

entry.Property("CreatedOn").CurrentValue = DateTimeOffset.UtcNow;

也可以显式指定UTC偏移构造：

entry.Property("CreatedOn").CurrentValue = new DateTimeOffset(DateTime.UtcNow, TimeSpan.Zero);

2. 强制保留序列化精度 #

如果使用System.Text.Json，全局配置Web API的序列化选项，确保DateTimeOffset保留7位小数精度和偏移信息：

builder.Services.AddControllers()
    .AddJsonOptions(options =>
    {
        options.JsonSerializerOptions.DateTimeFormat = new JsonDateTimeFormat
        {
            DateTimeOffsetFormat = "yyyy-MM-dd HH:mm:ss.fffffff zzz"
        };
    });

单独序列化时使用该配置：

var serializerOptions = new JsonSerializerOptions
{
    DateTimeFormat = new JsonDateTimeFormat
    {
        DateTimeOffsetFormat = "yyyy-MM-dd HH:mm:ss.fffffff zzz"
    }
};
var json = JsonSerializer.Serialize(yourEntity, serializerOptions);

3. 确认EF Core映射精度 #

在DbContext中明确配置字段映射，确保EF Core读取时完整获取数据库的7位小数精度：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<YourEntity>()
        .Property(e => e.CreatedOn)
        .HasColumnType("datetimeoffset(7)");
}

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