dotnet core Docker Web API 无法访问 localhost 及容器通信问题排查

• Docker内运行的Web API服务无法通过localhost正常访问，浏览器持续返回“无法访问此网站”提示
• 已参考JetBrains官方指南及网络公开教程，问题仍未解决
• 场景需求：本地开发环境下Web API容器需与Postgres容器实现双向通信；生产环境下容器需对接外部RDS实例

Dockerfile #

FROM mcr.microsoft.com/dotnet/core/sdk:3.1 AS base
WORKDIR /app
EXPOSE 8080
ENV ASPNETCORE_URLS=http://+:8080

# Copy csproj and restore as distinct layers
FROM mcr.microsoft.com/dotnet/core/sdk:3.1 AS build
WORKDIR /src
COPY . .
RUN dotnet restore "api/api.csproj"
WORKDIR "/src/api"
RUN dotnet build "api.csproj" -c Release -o /app

FROM build AS publish
WORKDIR "/src/api"
RUN dotnet publish "api.csproj" -c Release -o /app

FROM base AS final
WORKDIR /app
COPY --from=publish /app .
ENTRYPOINT ["dotnet", "api.dll", "--urls", "http://*:8080"]

LaunchSettings.json #

{
  "$schema": "http://json.schemastore.org/launchsettings.json",
  "iisSettings": {
    "windowsAuthentication": false,
    "anonymousAuthentication": true,
    "iisExpress": {
      "applicationUrl": "http://localhost:14317",
      "sslPort": 44301
    }
  },
  "profiles": {
    "IIS Express": {
      "commandName": "IISExpress",
      "launchBrowser": true,
      "launchUrl": "",
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Development"
      }
    },
    "wander.api": {
      "commandName": "Project",
      "launchBrowser": true,
      "launchUrl": "",
      "applicationUrl": "https://localhost:8081;http://localhost:8080",
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Development"
      }
    }
  }
}

1. 优先排查端口映射配置 #

容器EXPOSE指令仅为文档声明作用，不会自动将容器端口发布到宿主机

• 启动容器时必须通过-p参数建立宿主机端口与容器端口的映射，例如执行命令：docker run -p 8080:8080 <镜像ID>；如果使用docker-compose编排，需在对应服务下补充ports: - "8080:8080"配置
• 若使用JetBrains IDE自带的Docker调试配置，需检查端口绑定栏的设置：确认宿主机侧绑定IP为0.0.0.0，端口为8080，对应容器侧端口为8080，避免选择“仅容器内部可访问”的选项
• 检查宿主机8080端口是否被其他进程占用：Windows执行netstat -ano | findstr :8080，Mac/Linux执行lsof -i :8080，若存在占用需释放端口或在启动时改用其他宿主机端口做映射
• 注意LaunchSettings.json仅在本地直接执行dotnet run启动项目时生效，完全不会影响Docker容器内的服务运行逻辑，无需因为该文件的端口配置和Docker环境不一致误判为配置冲突

2. 修正Dockerfile配置瑕疵 #

• 当前base阶段直接使用.NET Core SDK镜像，该镜像为全量开发镜像，生产运行场景应替换为对应版本的ASP.NET Core运行时镜像，可减小镜像体积、降低安全风险：将base阶段的镜像源改为mcr.microsoft.com/dotnet/core/aspnet:3.1
• 现有配置存在重复设置监听地址的问题：ENV环境变量已指定ASPNETCORE_URLS=http://+:8080，ENTRYPOINT又重复传入--urls http://*:8080参数，建议删除其中一处冗余配置
• 现有分层构建逻辑破坏了Docker缓存机制：build阶段一开始就全量拷贝源码再执行restore，会导致每次代码改动都要重新拉取所有NuGet依赖。优化顺序为：先单独拷贝项目csproj文件执行restore，再拷贝全量源码执行构建发布

3. 容器间通信配置方案 #

• 开发环境下实现Web API与Postgres容器互通，需将两个容器接入同一个自定义Docker桥接网络：
  • 先创建独立开发网络：docker network create dev-net
  • 启动Postgres容器时通过--network dev-net参数加入该网络，同时指定容器名为postgres
  • 启动Web API容器时同样加入dev-net网络，应用内数据库连接地址直接填写postgres即可，无需使用localhost
• 生产环境下容器对接RDS实例时，无需将RDS纳入Docker网络，只要确保容器运行环境有访问RDS的网络权限即可

4. 启动日志校验 #

执行docker logs <运行中的容器ID>，确认Kestrel服务已成功启动、无端口绑定失败的报错；若存在绑定错误，需检查容器内的服务监听地址是否为0.0.0.0，而非仅绑定容器内的127.0.0.1地址。

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