Docker-Compose部署后无法访问Web内容（Swagger）的问题求助

问题场景 #

执行docker-compose build和docker-compose up -d启动容器后，无法通过URL访问API的Swagger文档；但在Visual Studio中点击运行按钮启动Docker-Compose时，Swagger可以正常访问，关闭VS后访问失效。

文件夹结构 #

- Solution
  - My.Web
    - Dockerfile
  - My.Lib
  - Solution.sln
  - docker-compose.yml
  - docker-compose.dcproj
  - docker-compose.override.yml

docker-compose.yml 内容 #

version: '3.4'

services:
  my.web:
    container_name: my-9
    environment:
      - ASPNETCORE_ENVIRONMENT:STAGING
      - ASPNETCORE_URLS=https://+:443;http://+:80
    ports:
      - "8080:80"
      - "443:443" 
    volumes:
      - ${APPDATA}/Microsoft/UserSecrets:C:\Users\ContainerUser\AppData\Roaming\Microsoft\UserSecrets:ro
      - ${APPDATA}/ASP.NET/Https:C:\Users\ContainerUser\AppData\Roaming\ASP.NET\Https:ro
    build:
      context: .
      dockerfile: My.Web\Dockerfile

Dockerfile 内容 #

FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS base
WORKDIR /app

ENV ASPNETCORE_URLS http://*:80
ENV ASPNETCORE_ENVIRONMENT=Development
EXPOSE 80
EXPOSE 443

FROM mcr.microsoft.com/dotnet/sdk:6.0 AS build
WORKDIR /src
COPY ["My.Web/My.Web.csproj", "My.Web/"]
COPY ["My.Lib/My.Lib.csproj", "My.Lib/"]
RUN dotnet restore "My.Web/My.Web.csproj"
COPY . .
WORKDIR "/src/My.Web"
RUN dotnet build "My.Web.csproj" -c Release -o /app/build

FROM build AS publish
RUN dotnet publish "My.Web.csproj" -c Release -o /app/publish

FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "My.Web.dll"]

问题根源分析 #

1. 环境变量冲突：Dockerfile中设置了ASPNETCORE_ENVIRONMENT=Development，但docker-compose.yml里又覆盖为STAGING。默认情况下，.NET项目的Swagger仅在Development环境下启用，所以STAGING环境下Swagger不会加载。
2. Visual Studio的配置覆盖：VS启动Docker-Compose时，会自动加载docker-compose.override.yml文件，该文件大概率将环境变量重置为Development，这就是VS中能访问Swagger的原因；单独运行docker-compose up时，默认只会加载主配置文件，使用STAGING环境。
3. 端口访问路径错误：容器端口80映射到宿主机8080，但可能你仍在尝试访问https://localhost:443/swagger，而容器内的HTTPS配置可能未正确加载证书，导致访问失败。

解决方案 #

方案1：统一环境变量为Development #

修改docker-compose.yml中的环境变量，将ASPNETCORE_ENVIRONMENT设为Development：

environment:
  - ASPNETCORE_ENVIRONMENT=Development
  - ASPNETCORE_URLS=https://+:443;http://+:80

修改后重新构建并启动容器：

docker-compose build
docker-compose up -d

然后访问http://localhost:8080/swagger即可。

方案2：允许STAGING环境加载Swagger #

如果需要保持STAGING环境，修改项目中的Swagger配置（通常在Program.cs中），添加STAGING环境的支持：

builder.Services.AddSwaggerGen();

// ...

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

重新构建镜像并启动容器，访问http://localhost:8080/swagger。

方案3：运行时加载override配置 #

如果想保留原有配置，启动容器时同时加载docker-compose.override.yml：

docker-compose -f docker-compose.yml -f docker-compose.override.yml up -d

VS启动时就是用的这个逻辑，这样会继承override中的环境配置（通常是Development）。

辅助排查：查看容器日志 #

如果以上方案无效，查看容器启动日志排查错误：

docker logs my-9

检查是否有端口绑定失败、环境变量加载异常或Swagger初始化错误的信息。

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