.NET 6 WebApi部署IIS后默认打开Swagger页面的问题

500错误的直接原因 #

你的代码遗漏了app.UseSwagger()中间件——UseSwaggerUI仅负责渲染Swagger界面，必须先启用Swagger JSON文档生成的中间件，否则UI无法找到对应的swagger.json文件，触发空参数的500错误。

完整修复配置 #

1. 补充Swagger核心中间件 #

在UseSwaggerUI之前必须添加app.UseSwagger()，开发/生产环境都需要：

// 必须先启用Swagger文档生成，这一步是核心
app.UseSwagger();

if (app.Environment.IsDevelopment())
{
    app.UseSwaggerUI(); // 开发环境默认路由前缀为空，直接访问根路径即可打开
}
else if (app.Environment.IsProduction())
{
    app.UseSwaggerUI(options =>
    {
        // 注意：部署为IIS子应用（WebApi）时，SwaggerEndpoint需加上子应用路径
        options.SwaggerEndpoint("/WebApi/swagger/v1.0/swagger.json", "v1.0");
        options.RoutePrefix = "api/swagger"; // 生产环境Swagger UI的访问路径为 /WebApi/api/swagger
    });
}

2. 添加根路径重定向逻辑 #

要实现访问https://localhost/WebApi自动跳转到Swagger，在Swagger配置后添加重定向代码：

// 根路径重定向到对应环境的Swagger UI
app.MapGet("/", context =>
{
    var targetPath = app.Environment.IsDevelopment() 
        ? "/swagger" 
        : "/api/swagger";
    return context.Response.Redirect(targetPath);
});

3. IIS配套设置 #

• 确保WebApi子应用的应用程序池设置为.NET CLR版本 = 无托管代码（适配.NET 6的跨平台特性）。
• 无需修改IIS的"默认文档"，通过代码重定向即可实现默认页跳转。

验证访问路径 #

• 开发环境：访问项目根路径自动跳转到Swagger UI。
• 生产环境：访问https://localhost/WebApi自动跳转到https://localhost/WebApi/api/swagger，Swagger界面正常加载文档。

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