ASP.NET Core 6 Web API的JWT认证在IIS部署后出现内部服务器错误

先拿到具体错误信息再说 #

500内部服务器错误只是个笼统提示，必须先抓准具体哪里出问题，推荐两种方式：

1. 加全局异常捕获中间件 #

在Program.cs里的app.MapControllers();之前加这段代码，重新发布后调用接口就能拿到详细报错：

app.UseExceptionHandler(errorApp =>
{
    errorApp.Run(async context =>
    {
        context.Response.StatusCode = StatusCodes.Status500InternalServerError;
        context.Response.ContentType = "application/json";

        var exceptionFeature = context.Features.Get<IExceptionHandlerPathFeature>();
        if (exceptionFeature != null)
        {
            var ex = exceptionFeature.Error;
            await context.Response.WriteAsync(System.Text.Json.JsonSerializer.Serialize(new
            {
                错误信息 = ex.Message,
                堆栈跟踪 = ex.StackTrace
            }));
        }
    });
});

2. 查IIS事件日志 #

打开Windows事件查看器，找Windows日志 -> 应用程序，筛选来源为ASP.NET Core的条目，里面会有完整的异常详情。

常见问题及解决办法 #

1. 配置文件没部署对 #

发布后appsettings.json可能丢了，或者生产环境的配置覆盖了关键参数：

• 去IIS站点的发布目录里检查appsettings.json，确保Jwt:SecretTokenKey有值（长度至少16位，HmacSha256要求密钥够长），数据库连接字符串、用户名密码也都正确。
• 如果用了appsettings.Production.json，确认它没有覆盖掉正确的配置项。

2. 数据库连接权限不够 #

IIS应用池的运行身份可能没权限访问SQL Server：

• 打开IIS管理器，找到你的应用池，右键高级设置，看标识字段。如果是默认的ApplicationPoolIdentity，去SQL Server里给这个身份加登录和数据库访问权限；或者直接换成有数据库权限的域账户/本地账户。
• 用SSMS直接测试生产环境的连接字符串，确认能正常连上数据库。

3. JWT密钥编码出问题 #

如果你的Jwt:SecretTokenKey包含中文或非ASCII字符，用Encoding.ASCII.GetBytes会丢数据，换成UTF8编码：

// Program.cs里修改
IssuerSigningKey = new SymmetricSecurityKey(Encoding.UTF8.GetBytes(builder.Configuration["Jwt:SecretTokenKey"])),

// JwtAuthenticationManager里修改
var tokenKey = Encoding.UTF8.GetBytes(key);

4. 依赖注入的配置没取到 #

原来的单例注册方式可能导致配置加载异常，改成工厂模式注入更稳妥：

// 替换Program.cs里的注册代码
builder.Services.AddSingleton<IJwtAuthenticationManager>(sp =>
{
    var config = sp.GetRequiredService<IConfiguration>();
    var secretKey = config["Jwt:SecretTokenKey"] ?? throw new InvalidOperationException("未配置Jwt:SecretTokenKey");
    return new JwtAuthenticationManager(secretKey);
});

5. Pool单例初始化失败 #

Pool.Instance.Profiles.GetChunk这个单例对象在IIS环境下可能没正确初始化数据库连接：

• 检查Pool类的初始化逻辑，确认应用启动时已经建立了有效数据库连接。
• 验证ConnectionStringHandler传递的连接字符串在生产环境能正常用。

6. HTTPS重定向坑 #

如果IIS没配置HTTPS，app.UseHttpsRedirection()会导致重定向错误，先注释掉这段代码，或者在IIS里配置好HTTPS证书。

额外排查建议 #

• 打开日志记录，在appsettings.json里加这段，然后看发布目录的Logs文件夹，能拿到更细的运行日志：

{
  "Logging": {
    "LogLevel": {
      "Default": "Debug",
      "Microsoft.AspNetCore": "Debug"
    }
  }
}

• 确认发布时选对了目标框架，所有NuGet依赖包都部署到了IIS目录里。

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