在.NET Core 2.0中通过JwtBearerEvents返回500错误异常信息

我来帮你把OnAuthenticationFailed事件的逻辑补全，确保认证过程中出现500错误时，能把异常信息正确返回给用户。下面是完整的配置代码，包含你已有部分的完善：

services.AddAuthentication(JwtBearerDefaults.AuthenticationScheme)
    .AddJwtBearer(options =>
    {
        // 替换成你的Azure AD租户ID和客户端ID
        options.Authority = "https://login.microsoftonline.com/your-tenant-id/v2.0";
        options.Audience = "your-client-id";

        options.Events = new JwtBearerEvents
        {
            OnTokenValidated = AzureAdAuthCallbacks.TokenValidated,
            OnAuthenticationFailed = async context =>
            {
                // 设置响应为JSON格式，比纯文本更适合API场景
                context.Response.ContentType = "application/json";
                // 标记为500内部服务器错误
                context.Response.StatusCode = StatusCodes.Status500InternalServerError;

                // 构造错误响应内容，注意区分开发/生产环境
                var errorDetails = new
                {
                    Message = "认证过程中发生内部错误",
                    // 开发环境返回详细异常信息，生产环境建议隐藏敏感内容
                    DetailedMessage = Environment.IsDevelopment() ? context.Exception.Message : "请联系管理员获取更多信息",
                    StackTrace = Environment.IsDevelopment() ? context.Exception.StackTrace : null
                };

                // 将错误信息序列化为JSON并写入响应流
                await context.Response.WriteAsync(System.Text.Json.JsonSerializer.Serialize(errorDetails));
            }
        };
    });

几个关键注意点： #

• 环境隔离：生产环境绝对不要返回异常堆栈或详细错误信息，避免泄露系统敏感细节，上面的代码通过Environment.IsDevelopment()做了自动区分，你可以根据实际需求调整。
• 响应规范：用application/json替代text/plain更符合REST API的设计规范，前端也更容易解析处理。
• 状态码精准性：不是所有认证失败都是500，比如令牌过期应该返回401，你可以根据异常类型细化处理：

  if (context.Exception is Microsoft.IdentityModel.Tokens.SecurityTokenExpiredException)
  {
      context.Response.StatusCode = StatusCodes.Status401Unauthorized;
      errorDetails.Message = "身份令牌已过期，请重新登录";
  }
  else
  {
      context.Response.StatusCode = StatusCodes.Status500InternalServerError;
  }
  

• 异步操作完成：一定要确保调用await context.Response.WriteAsync(...)完成响应写入，否则客户端可能收不到完整的错误信息。

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