.NET 7应用通过SDK容器化后如何访问Swagger页面？

核心原因 #

Swagger（Swashbuckle）默认仅在Development开发环境下启用，而你使用-c Release发布构建，容器运行时默认环境为Production生产环境，因此Swagger端点未被注册，访问/swagger/index.html会返回404。

解决方案 #

方案1：允许生产环境访问Swagger（仅用于调试，不建议正式生产环境使用） #

修改项目中的Program.cs，调整Swagger的启用逻辑：

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddControllers();
builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen();

var app = builder.Build();

// 移除环境限制，让所有环境都启用Swagger
app.UseSwagger();
app.UseSwaggerUI();

// 或者指定包含Production环境
// if (app.Environment.IsDevelopment() || app.Environment.IsProduction())
// {
//     app.UseSwagger();
//     app.UseSwaggerUI();
// }

app.UseAuthorization();
app.MapControllers();
app.Run();

方案2：容器运行时指定Development环境（推荐调试场景使用） #

运行容器时通过环境变量ASPNETCORE_ENVIRONMENT切换到开发环境：

docker run --rm -it -p 5999:80 -e ASPNETCORE_ENVIRONMENT=Development f14ea411b07b21adfdf7cfb80e910dcf63577c2e578f6a1c23d7825f35b51752

方案3：将开发环境配置持久化到镜像（调试场景用） #

在csproj文件中添加环境变量配置，让镜像默认使用开发环境：

<PropertyGroup>
  <!-- 保留原有配置 -->
  <ContainerEnvironmentVariable Include="ASPNETCORE_ENVIRONMENT" Value="Development" />
</PropertyGroup>

添加后重新执行构建镜像的命令即可。

验证方法 #

修改完成后重新构建并运行容器，访问http://localhost:5999/swagger/index.html，即可正常加载Swagger页面。

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