MVC控制器DateTimeOffset序列化异常：本地正常Azure容器时区偏移错误

问题现象 #

MVC控制器返回的OpeningHours模型中，Opens和Closes字段的时区偏移在本地Mac开发环境显示为+10:00，但部署到Azure AKS容器后变为+00:00，本地与容器序列化结果不一致。

环境信息 #

• 本地开发：Intel MacOS（时区为澳东时区+10:00）
• 部署环境：Azure AKS容器
• ASP.NET Core版本：3.0
• 序列化核心配置：

services
    .AddControllers(options => { options.EnableEndpointRouting = true; })
    .SetCompatibilityVersion(CompatibilityVersion.Version_3_0)
    .AddNewtonsoftJson(options =>
    {
        options.SerializerSettings.ContractResolver = new CamelCasePropertyNamesContractResolver();
        options.SerializerSettings.DateFormatHandling = DateFormatHandling.IsoDateFormat;
        options.SerializerSettings.DateTimeZoneHandling = DateTimeZoneHandling.RoundtripKind;
        options.SerializerSettings.NullValueHandling = NullValueHandling.Include;
        options.SerializerSettings.DefaultValueHandling = DefaultValueHandling.Include;
    });

• 模型定义：

public class OpeningHours
{
    public DateTime Opens { get; init; }
    public DateTime Closes { get; init; }
}

可能原因及解决建议 #

1. 容器系统时区默认为UTC #

Azure AKS容器默认使用UTC时区（+00:00），而本地Mac使用澳东时区（+10:00）。当DateTime的Kind为Unspecified时，Newtonsoft.Json会基于当前系统时区生成偏移信息，导致本地和容器结果不同。

解决方式：
在容器部署配置中添加时区环境变量，指定澳东时区：

# Deployment配置片段
env:
  - name: TZ
    value: "Australia/Sydney"

2. DateTime的Kind属性未明确指定 #

如果DateTime数据来源（如数据库、前端传入）未设置Kind属性（默认DateTimeKind.Unspecified），序列化时会依赖系统时区推断偏移。本地环境时区为+10，容器为UTC，因此输出偏移不同。

解决方式：

• 改用DateTimeOffset类型替代DateTime，该类型自带时区偏移信息，不受系统时区影响：

  public class OpeningHours
  {
      public DateTimeOffset Opens { get; init; }
      public DateTimeOffset Closes { get; init; }
  }
  

• 若必须使用DateTime，在赋值时明确指定Kind：

  // 示例：将无时区信息的DateTime转为指定时区类型
  var rawDate = DateTime.Parse("2022-11-22T11:00:00");
  var specifiedDate = DateTime.SpecifyKind(rawDate, DateTimeKind.Local); // 或DateTimeKind.Utc
  

3. 序列化配置未强制指定时区 #

当前配置使用DateTimeZoneHandling.RoundtripKind，该规则仅在DateTime的Kind明确时才保留偏移，若Kind为Unspecified则会使用系统时区。可修改配置强制指定序列化时区：

解决方式：
修改Newtonsoft.Json配置，强制使用澳东时区序列化：

options.SerializerSettings.DateTimeZoneHandling = DateTimeZoneHandling.Local;
options.SerializerSettings.TimeZone = TimeZoneInfo.FindSystemTimeZoneById("AUS Eastern Standard Time");

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