ASP.NET Core Web API集成Azure AD认证时出现500错误求助

这个500错误的核心原因是未配置默认认证方案或默认挑战方案：当授权中间件需要触发认证挑战时，找不到对应的处理逻辑，因此抛出异常，而非预期的401未授权响应。

具体修复步骤： #

1. 修正ConfigureServices中的认证配置

确保在添加Azure AD认证时明确指定默认认证方案，推荐使用Microsoft.Identity.Web包简化配置，示例代码：

using Microsoft.AspNetCore.Authentication.JwtBearer;
using Microsoft.Identity.Web;

public void ConfigureServices(IServiceCollection services)
{
    // 配置Azure AD并设置默认认证方案为JWT Bearer
    services.AddAuthentication(JwtBearerDefaults.AuthenticationScheme)
        .AddMicrosoftIdentityWebApi(Configuration.GetSection("AzureAd"));

    // 其他服务配置
    services.AddControllers();
    services.AddSwaggerGen();
}

2. 确认中间件顺序正确

在Program.cs（或Startup的Configure方法）中，UseAuthentication必须在UseAuthorization之前，确保认证逻辑先于授权执行：

var app = builder.Build();

if (app.Environment.IsDevelopment())
{
    app.UseDeveloperExceptionPage();
    app.UseSwagger();
    app.UseSwaggerUI();
}

app.UseHttpsRedirection();

// 顺序不可颠倒
app.UseAuthentication();
app.UseAuthorization();

app.MapControllers();

app.Run();

3. 验证appsettings.json配置正确性

确保Azure AD相关配置项完整且准确：

"AzureAd": {
    "Instance": "https://login.microsoftonline.com/",
    "Domain": "your-domain.onmicrosoft.com",
    "TenantId": "你的租户ID",
    "ClientId": "你的API客户端ID",
    "Audience": "api://你的API客户端ID"
}

修复后效果 #

配置完成后，当未传递token时，接口会正常返回401 Unauthorized；传递有效的Azure AD令牌时，可成功访问授权接口。

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