基于默认模板的.NET Core 3.1 REST API部署到Docker容器后无法访问

最快验证方案 #

你可以先直接执行以下启动命令测试，不需要修改现有Dockerfile：

docker run -d -p 5000:80 <你的镜像名称>

启动完成后访问http://localhost:5000/weatherforecast即可正常请求接口，原因如下： #

核心问题原因 #

1. 端口映射未配置 #

Dockerfile中的EXPOSE仅为端口声明，不会自动建立宿主机到容器的端口映射，必须在docker run时通过-p <宿主机端口>:<容器端口>参数显式绑定。

2. 程序默认监听端口与声明不一致 #

微软官方mcr.microsoft.com/dotnet/aspnet:3.1镜像默认设置了环境变量ASPNETCORE_URLS=http://+:80，也就是说你的.NET程序在容器内默认只会监听80端口，你Dockerfile中声明的5000端口并没有被程序实际监听，所以直接绑定5000端口会访问失败。 #

完整配置方案（如果需要自定义监听端口为5000） #

步骤1：修改Dockerfile添加监听配置 #

在ENTRYPOINT指令前新增环境变量配置：

FROM mcr.microsoft.com/dotnet/aspnet:3.1
COPY bin/Release/netcoreapp3.1/publish App/
WORKDIR /App
EXPOSE 5000
# 新增这一行，指定程序监听5000端口
ENV ASPNETCORE_URLS=http://+:5000
ENTRYPOINT ["dotnet", "CoreRestApi.dll"]

步骤2：重新构建镜像 #

docker build -t <你的镜像名称> .

步骤3：启动容器并绑定端口 #

docker run -d -p 5000:5000 <你的镜像名称>

其他排查方向 #

• 确认执行构建前已经运行dotnet publish -c Release命令，bin/Release/netcoreapp3.1/publish目录下存在完整的发布文件，特别是CoreRestApi.dll文件存在。
• 如果启动后仍然访问失败，执行docker logs <容器ID/容器名称>查看程序运行日志，排查是否存在启动报错。

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