.NET Core API本地系统时间与本地时间不一致及JWT验证异常求助

问题描述 #

我在Windows机器本地运行.NET Core API项目，本地时区为UTC+3，但接口返回响应头中的时间为UTC+0时区时间。这种时间差导致我无法验证JWT令牌，始终验证失败。

示例：

• 本地时间：15:45:51
• (Kestrel) .NET时间：12:45:51

我尝试过使用TimeZoneInfo但没有效果。我希望在自己的时区中查看和处理令牌有效期相关操作，不想通过UtcNow来计算时差。是否可以让.NET中的系统时间与本地时间匹配？

补充说明 #

即便我使用DateTime.Now设置令牌过期时间，它仍会被转换为UtcNow的值，导致令牌始终处于无效状态。当前本地时间为16:24，相关代码如下：

var minute = Convert.ToInt32(_configuration["JwtSettings:ExpirationInMinutes"]);
token.Expiration = DateTime.Now.AddMinutes(minute);

JwtSecurityToken securityToken = new(
    audience: _configuration["JwtSettings:Audience"],
    issuer: _configuration["JwtSettings:Issuer"],
    expires: token.Expiration,
    notBefore: DateTime.Now,
    signingCredentials: signingCredentials
);

如果我使用UtcNow设置日期，验证可以正常进行，但为何我传入的DateTime.Now值会被转换为UtcNow？

解决方案与原因解析 #

为什么DateTime.Now会被转成UTC时间？ #

JWT标准（RFC 7519）明确要求令牌中的时间声明（exp、nbf等）必须使用UTC时间。JwtSecurityToken构造函数在处理DateTime类型参数时，会自动将未标记为UTC的DateTime值（比如DateTime.Now的Kind属性为Local）转换为UTC时间——这是框架遵循JWT标准的强制行为，目的是保证跨时区环境下的时间一致性。

你用DateTime.Now设置的过期时间，会被框架转成UTC时间存储在JWT中，而验证时组件会用当前UTC时间去比对，这就和你本地时间差了3小时，自然验证失败。

能否让.NET系统时间与本地时间匹配？ #

.NET的系统时间本质基于操作系统的UTC时间，显示时才会转换为本地时区。你无法强制让.NET直接用本地时区作为"系统时间"（这会破坏跨时区应用的一致性），但可以通过以下方式在本地时区下处理JWT时间：

1. 用DateTimeOffset显式管理时区
   DateTimeOffset会保留时区偏移信息，你可以在业务层用它处理本地时间，构造JWT时再转成UTC时间传入：

   var localNow = DateTimeOffset.Now;
   var minute = Convert.ToInt32(_configuration["JwtSettings:ExpirationInMinutes"]);
   var expiration = localNow.AddMinutes(minute);
   
   JwtSecurityToken securityToken = new(
       audience: _configuration["JwtSettings:Audience"],
       issuer: _configuration["JwtSettings:Issuer"],
       expires: expiration.UtcDateTime,
       notBefore: localNow.UtcDateTime,
       signingCredentials: signingCredentials
   );
   

   这样你在业务逻辑里用的是带UTC+3偏移的时间，同时满足JWT的UTC要求。

2. 自定义JWT验证逻辑（仅调试用）
   如果你只想在本地调试时适配时区，可以自定义时间验证逻辑，但这违反JWT标准，绝对不能在生产环境使用：

   services.AddAuthentication(JwtBearerDefaults.AuthenticationScheme)
       .AddJwtBearer(options =>
       {
           options.TokenValidationParameters = new TokenValidationParameters
           {
               ValidateIssuer = true,
               ValidateAudience = true,
               ValidateLifetime = true,
               ValidateIssuerSigningKey = true,
               LifetimeValidator = (before, expires, token, parameters) =>
               {
                   var localNow = DateTime.Now;
                   var utcNow = localNow.ToUniversalTime();
                   return expires.HasValue && utcNow < expires.Value;
               }
           };
       });
   

3. 项目中统一用DateTimeOffset处理时间
   尽量避免直接使用DateTime.Now或DateTime.UtcNow，改用DateTimeOffset.Now（带本地偏移）或DateTimeOffset.UtcNow，这样能明确时间的时区属性，减少混淆。

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