.NET 9 Minimal API部署至IIS 10后BadRequest无响应体

问题原因 #

IIS 10默认会接管4xx/5xx这类错误状态码，自动将响应替换为IIS自带的错误页面，导致你通过TypedResults.BadRequest或TypedResults.Problem返回的自定义响应体被覆盖，最终浏览器只收到无内容的400状态码。

解决步骤 #

1. 修改web.config禁用IIS错误拦截 #

在部署生成的web.config文件中，添加<httpErrors>配置，让IIS直接传递.NET生成的响应：

<configuration>
  <system.webServer>
    <!-- 保留原有其他配置 -->
    <httpErrors existingResponse="PassThrough" />
  </system.webServer>
</configuration>

这个配置强制IIS不替换已存在的响应内容，确保你的自定义BadRequest响应体能正常返回。

2. 调整.NET中间件配置 #

移除UseStatusCodePages()中间件（它会覆盖自定义错误响应），改用UseExceptionHandler()处理未捕获异常，同时保留主动返回的自定义响应：

var builder = WebApplication.CreateBuilder(args);

// 注册必要服务（如Swagger、日志等）
// builder.Services.AddSwaggerGen();

var app = builder.Build();

if (!app.Environment.IsDevelopment())
{
    // 仅在生产环境捕获未处理异常，不干扰主动返回的错误响应
    app.UseExceptionHandler();
}

// 映射你的端点
app.MapGet("/some-endpoint", SomeEndpoint);
app.MapGet("/some-endpoint-problem", SomeEndpointWithProblem);

app.Run();

3. 验证端点返回格式 #

如果需要明确返回格式（如纯文本而非JSON），可以在TypedResults.BadRequest中指定内容类型：

// 返回纯文本格式的BadRequest响应
private static async Task<Results<BadRequest<string>, Created>> SomeEndpoint(string input)
{
    return TypedResults.BadRequest("Everything is fubar", "text/plain");
};

额外检查项 #

• 确认IIS应用池的**.NET CLR版本**设置为No Managed Code（.NET 9为独立部署，无需IIS托管CLR）
• 检查IIS的请求筛选配置，确保没有拦截400状态码或特定响应内容

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