.NET 7下ASP.NET Core WebAPI的Swagger UI空白问题如何修复？

以下是针对升级至.NET 7后Swagger UI空白（但页面源码完整）问题的常见修复手段：

1. 确保静态资源访问中间件配置正确 #

.NET 7对静态资源的处理逻辑有微调，需显式启用静态资源访问，且必须放在UseSwaggerUI之前，否则Swagger UI无法加载依赖的JS/CSS文件：

var app = builder.Build();

// 先启用静态文件支持
app.UseStaticFiles();

if (app.Environment.IsDevelopment())
{
    app.UseSwagger();
    app.UseSwaggerUI(c =>
    {
        c.SwaggerEndpoint("/swagger/v1/swagger.json", "ACC API V1");
    });
}

2. 验证Swagger JSON端点路径有效性 #

直接在浏览器访问Swagger JSON的路径（比如/swagger/v1/swagger.json），确认能正常返回API文档JSON。如果项目配置了自定义路径前缀（如app.UsePathBase("/api")），需同步修改SwaggerEndpoint的路径：

c.SwaggerEndpoint("/api/swagger/v1/swagger.json", "ACC API V1");

3. 升级Swagger依赖包至兼容版本 #

确保Swashbuckle.AspNetCore系列包的版本适配.NET 7，建议升级到6.x或7.x的稳定版，避免版本不兼容导致的资源加载失败。在acc.csproj中更新包引用：

<PackageReference Include="Swashbuckle.AspNetCore" Version="6.4.0" />

4. 检查中间件执行顺序 #

中间件顺序错误会导致Swagger UI无法正常初始化，需确保UseSwagger和UseSwaggerUI的位置在UseRouting之后、UseAuthorization之前：

app.UseRouting();

app.UseAuthorization();

// 开发环境启用Swagger
if (app.Environment.IsDevelopment())
{
    app.UseSwagger();
    app.UseSwaggerUI();
}

app.MapControllers();

5. 调整内容安全策略（CSP）配置 #

如果项目配置了CSP，可能拦截了Swagger UI的内联脚本或样式。修改CSP规则，允许必要的资源加载：

app.Use(async (context, next) =>
{
    context.Response.Headers.Add(
        "Content-Security-Policy",
        "default-src 'self'; script-src 'self' 'unsafe-inline'; style-src 'self' 'unsafe-inline'; img-src 'self' data:;"
    );
    await next();
});

6. 排查路由冲突 #

检查项目中是否有自定义路由（如控制器路由[Route("swagger")]）与Swagger的默认路径冲突，此类冲突会导致Swagger资源被拦截，需修改自定义路由避免重叠。

内容的提问来源于stack exchange，提问作者Đỗ Như Vỹ