打开Swagger-UI仅返回JSON响应，求助正常显示Swagger UI

看起来你现在访问Swagger时拿到的是JSON文档，而不是可视化的UI界面，我帮你梳理几个常见的排查和解决方向：

1. 确认Swagger UI中间件已正确注册 #

首先检查你的项目配置文件（.NET 6+是Program.cs，旧版本是Startup.cs），确保同时注册了UseSwagger和UseSwaggerUI中间件，并且顺序正确：

// 先启用Swagger JSON生成
app.UseSwagger();

// 再启用Swagger UI
app.UseSwaggerUI(c => 
{
    // 指定Swagger JSON的路径，要和你生成的版本匹配
    c.SwaggerEndpoint("/swagger/v1/swagger.json", "你的API名称 V1");
    
    // 可选：如果想直接通过根域名访问UI，设置路由前缀为空
    // c.RoutePrefix = string.Empty;
});

注意：UseSwagger必须在UseSwaggerUI之前，否则UI无法加载到JSON数据。

2. 检查环境限制配置 #

很多项目会默认只在开发环境启用Swagger，如果你的Azure环境是生产环境，可能被环境判断拦截了。检查代码里是否有类似这样的逻辑：

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

如果是这样，你可以：

• 移除环境判断（注意生产环境的安全风险，建议后续添加认证限制）
• 或者修改判断逻辑，允许生产环境启用，比如添加环境变量控制：

  bool enableSwagger = app.Environment.IsDevelopment() || 
                       bool.Parse(builder.Configuration["EnableSwaggerInProduction"] ?? "false");
  if (enableSwagger)
  {
      app.UseSwagger();
      app.UseSwaggerUI();
  }
  

然后在Azure App Service的“应用设置”里添加EnableSwaggerInProduction并设为true。

3. 确认访问的是正确的UI路径 #

默认情况下，Swagger UI的访问地址是：https://你的域名/swagger/index.html，如果你直接访问的是/swagger/v1/swagger.json，那自然会看到JSON文档。

如果你设置了c.RoutePrefix = string.Empty;，则直接访问根域名（https://你的域名/）就能看到UI。

4. 检查Azure环境的静态文件配置 #

Swagger UI依赖静态资源（CSS、JS文件）来渲染界面，确保你的项目中已经启用了静态文件中间件，并且放在Swagger相关中间件之前：

// 启用静态文件支持，必须在UseSwaggerUI之前
app.UseStaticFiles();

app.UseSwagger();
app.UseSwaggerUI();

另外，Azure App Service默认不会禁用静态文件，但如果你的项目有特殊配置（比如自定义中间件拦截静态资源），需要排查是否影响了Swagger的静态资源加载。

5. 排查认证/授权拦截 #

如果你的API启用了认证（比如JWT），可能授权中间件拦截了Swagger UI的请求。可以给Swagger相关路径添加匿名访问权限：

app.UseAuthorization();

// 允许Swagger JSON和UI路径匿名访问
app.MapSwagger().RequireAuthorization(false);
app.MapSwaggerUI().RequireAuthorization(false);

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