ASP.NET Core 6.0 Minimal API部署到IIS后Swagger报404问题求助

1. 确认Swagger的环境启用限制 #

ASP.NET Core默认模板中Swagger通常仅在Development环境下加载，部署到IIS后默认运行在Production环境，会导致Swagger中间件未注册。检查你的Program.cs是否存在如下判断逻辑：

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

如果是这种情况，可按需求调整：

• 测试场景：在IIS站点的环境变量中添加ASPNETCORE_ENVIRONMENT=Development
• 生产场景（需注意安全）：修改代码允许生产环境启用Swagger，比如添加IP白名单限制：

bool enableSwagger = app.Environment.IsDevelopment() || 
                     app.Environment.IsProduction(); // 根据实际需求调整
if (enableSwagger)
{
    app.UseSwagger();
    app.UseSwaggerUI();
}

2. 检查IIS应用程序池配置 #

• 确认应用程序池的**.NET CLR版本**设置为无托管代码（ASP.NET Core为自托管模式，IIS仅做反向代理）
• 核实应用程序池的身份权限：即便已给IIS_IUSRS文件夹权限，若应用池使用自定义账户，需确保该账户同样拥有站点文件的访问权限

3. 验证发布文件完整性 #

• 检查发布目录中是否存在API的XML注释文件（若启用了XML注释生成）：需在项目属性的生成选项中勾选XML文档文件，并确保发布配置包含该文件
• 确认web.config配置正确，重点检查aspNetCore节点：

<aspNetCore processPath="dotnet" arguments=".\YourApi.dll" stdoutLogEnabled="false" stdoutLogFile=".\logs\stdout" hostingModel="inprocess" />

可临时开启stdoutLogEnabled="true"，查看日志目录下的启动输出，排查初始化错误

4. 核对Swagger端点与路由配置 #

• 检查Program.cs中Swagger的端点路径配置是否匹配访问地址：

app.UseSwagger(c =>
{
    c.RouteTemplate = "swagger/{documentName}/swagger.json";
});
app.UseSwaggerUI(c =>
{
    c.SwaggerEndpoint("/swagger/v1/swagger.json", "Your API V1");
    c.RoutePrefix = "swagger";
});

若IIS站点使用虚拟目录而非根站点，SwaggerEndpoint路径需添加虚拟目录名称，比如/YourVirtualDir/swagger/v1/swagger.json

5. 确认IIS URL重写模块已安装 #

ASP.NET Core依赖URL重写模块转发请求到Kestrel，检查该模块是否启用：
打开控制面板 > 程序 > 启用或关闭Windows功能，确认Internet Information Services > World Wide Web Services > Application Development Features > URL重写已勾选

6. 跳过IIS直接测试Kestrel服务 #

在服务器上直接运行dotnet YourApi.dll，访问http://localhost:5000/swagger/v1/swagger.json（默认端口）：

• 若能正常访问，说明问题出在IIS配置层面
• 若仍返回404，说明API本身的Swagger配置存在问题

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