.NET 6应用Docker部署后无法访问Swagger页面问题咨询

核心故障原因 #

• Swagger默认仅开发环境启用：.NET 6官方项目模板默认将Swagger中间件的注册逻辑包裹在IsDevelopment()环境判断中，Docker容器运行时默认环境为Production，因此Swagger相关中间件不会被加载，对应路由自然无法访问。
• 端口映射配置错误：你的Dockerfile中明确声明EXPOSE 80，且未额外配置的情况下，ASP.NET Core镜像默认监听容器内的80端口，但你执行的启动命令中将宿主机42419端口映射到了容器内的42419端口，容器内无服务监听该端口，导致请求无法到达应用。

解决方案 #

方案1：允许生产环境启用Swagger（适合测试场景，生产环境按需选择） #

修改你项目中的Program.cs文件，将Swagger相关注册逻辑移出开发环境判断：

// 原代码
if (app.Environment.IsDevelopment())
{
    app.UseSwagger();
    app.UseSwaggerUI();
}

// 修改后
app.UseSwagger();
app.UseSwaggerUI();

// 保留其他开发环境专属中间件逻辑
if (app.Environment.IsDevelopment())
{
    app.UseDeveloperExceptionPage();
}

修改后重新构建镜像，使用正确的端口映射命令启动容器：
docker run -d -p 42419:80 --name apitest containername/tag:latest

方案2：容器指定开发环境运行（适合本地调试场景） #

无需修改代码，直接在启动容器时添加环境变量指定运行环境为开发环境，同时修正端口映射：
docker run -d -p 42419:80 -e ASPNETCORE_ENVIRONMENT=Development --name apitest containername/tag:latest

可选方案：保持容器内使用42419端口 #

如果需要容器内应用也监听42419端口，修改Dockerfile的base阶段，添加环境变量指定监听端口：

FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS base
WORKDIR /app
EXPOSE 42419
ENV ASPNETCORE_URLS=http://+:42419

修改后重新构建镜像，即可使用你原来的启动命令运行，同时可搭配上面两种Swagger启用方案使用。

验证方法 #

容器启动后可执行docker logs apitest查看应用运行日志，确认监听端口是否正确、是否有报错信息，访问http://localhost:42419/swagger即可打开Swagger页面。

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