ASP.NET Core Web API中MongoDB存储时间偏移不一致问题

核心原因 #

1. DateTime类型的时区歧义
   .NET中DateTime类型的Kind属性（Unspecified/Utc/Local）会导致反序列化和存储时行为不一致：

• 前端传递的日期如果不带时区信息，反序列化后Kind会被标记为Unspecified
• MongoDB驱动处理Unspecified类型的DateTime时，可能会根据服务器本地时区自动转换为UTC，若服务器时区或驱动配置有变化，就会出现偏移差异

2. 夏令时切换的叠加影响
   2023年3月12日EST切换为EDT（EST=UTC-5，EDT=UTC-4）：

• 第一条记录的Date字段2023-03-15T05:00:00.000+00:00对应EST时区的2023-03-15 00:00（05:00-5）
• 后两条的Date字段2023-03-15T04:00:00.000+00:00对应EDT时区的2023-03-15 00:00（04:00-4）
  说明部分请求的日期在前端处理时未正确适配夏令时，或后端转换逻辑未统一时区规则

3. CreatedAt的时区依赖问题
   使用DateTime.Now会依赖服务器本地时区，若服务器不在EST/EDT时区，存储到MongoDB时的UTC转换逻辑可能和Date字段的处理不一致，加剧偏移差异

解决方案 #

1. 替换为DateTimeOffset类型 #

修改RequestModel，用DateTimeOffset替代DateTime，明确携带时区偏移信息，消除歧义：

public class RequestModel 
{
    public int Id { get; set; }
    public DateTimeOffset Date { get; set; }
    public DateTimeOffset CreatedAt { get; set; }
}

2. 统一UTC时间处理逻辑 #

• 前端传递日期时，确保携带正确的时区偏移（如EST传2023-03-15T00:00:00-05:00，EDT传2023-03-15T00:00:00-04:00）
• 后端接收后统一转换为UTC存储，或直接存储DateTimeOffset，MongoDB会保留时区信息

3. 修正CreatedAt的生成方式 #

改用DateTimeOffset.UtcNow生成UTC时间，避免服务器本地时区影响：

[HttpPost]
public async Task Create([FromBody] RequestModel request, CancellationToken cancellationToken = default)
{
    request.CreatedAt = DateTimeOffset.UtcNow;
    // Store request in database
}

4. 明确时区转换规则（若需保留DateTime类型） #

如果必须使用DateTime，需在反序列化和存储时明确指定时区：

// 示例：将接收到的Date转换为EST/EDT时区后转UTC
var estTimeZone = TimeZoneInfo.FindSystemTimeZoneById("Eastern Standard Time");
var dateInEst = TimeZoneInfo.ConvertTimeFromUtc(request.Date.ToUniversalTime(), estTimeZone);
var utcDate = dateInEst.ToUniversalTime();

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