.NET Core 5+Vue 2x项目Docker部署Ubuntu后JWT始终返回401问题求助

1. 修正JWT密钥读取错误 #

Startup类中读取JWT密钥的代码存在逻辑错误，GetSection("JwtKey")返回的是IConfigurationSection配置节对象，直接调用ToString()不会返回配置的密钥值，只会返回对象的类型名称，这是问题的核心诱因：

// 错误写法
IssuerSigningKey = new SymmetricSecurityKey(Encoding.ASCII.GetBytes(Configuration.GetSection("JwtKey").ToString()))

修改为以下任意一种正确写法即可：

// 直接读取根节点配置项
IssuerSigningKey = new SymmetricSecurityKey(Encoding.ASCII.GetBytes(Configuration["JwtKey"]))
// 读取配置节的Value属性
IssuerSigningKey = new SymmetricSecurityKey(Encoding.ASCII.GetBytes(Configuration.GetSection("JwtKey").Value))

本地Windows环境未触发问题，是因为本地测试时生成token和校验token的密钥碰巧一致，或者Windows环境下的配置读取容错性掩盖了这个错误，到了区分大小写、配置加载逻辑更严格的Linux容器环境下问题就暴露了。

2. 确认密钥配置一致性 #

• 检查UserService中生成token的Auhtenticate方法，确保生成token用的密钥和Startup中配置的校验密钥完全一致
• 确认服务器环境的JwtKey配置到位：如果通过环境变量注入密钥，需要在docker-compose的environment节点新增配置：

environment:
  - JwtKey=替换为你的实际JWT密钥字符串
  # 原有其他环境变量保持不变

如果密钥存放在appsettings.json中，确认打包镜像时该文件被正确包含在发布目录，且密钥值正确。

3. 排查时区导致的token过期问题 #

JWT默认会校验token的有效时间，如果容器时区和业务逻辑中设置的token过期时间时区偏差过大，会导致刚生成的token直接被判定为过期。可以在docker-compose中添加时区配置同步宿主机时间：

services:
  koolbackend:
    # 其他配置不变
    environment:
      - TZ=Asia/Shanghai # 替换为你所在的对应时区

4. 开启JWT调试日志精准定位 #

如果按上述步骤操作后问题仍存在，可以添加JWT认证失败的事件监听，打印具体错误原因到日志：

.AddJwtBearer(token =>
{
    // 原有JWT配置保持不变
    token.Events = new JwtBearerEvents
    {
        OnAuthenticationFailed = context =>
        {
            Console.WriteLine("JWT认证失败原因：" + context.Exception.Message);
            return Task.CompletedTask;
        }
    };
});

部署后查看容器日志即可拿到具体错误信息，进一步针对性排查。

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