如何创建支持dotnet watch run热重载的.NET 6 Docker容器

1. 核心问题前置说明 #

你遇到的所有报错本质都指向三个配置疏漏：基础镜像类型错误、容器端口绑定规则错误、文件挂载逻辑错误，以下是可直接复用的完整方案： #

2. 编写Dockerfile #

不要使用runtime类型的.NET 6镜像，必须使用完整SDK镜像，否则会直接触发"watch" is not something dotnet can run报错。

# 基础镜像必须选SDK版
FROM mcr.microsoft.com/dotnet/sdk:6.0 AS base
# 容器内工作目录
WORKDIR /app
# 暴露端口，可根据自身需求修改
EXPOSE 5000
EXPOSE 5001
# 配置环境变量解决核心问题
# 开启文件轮询检测，解决容器挂载卷无法触发文件变更通知的问题
ENV DOTNET_USE_POLLING_FILE_WATCHER 1
# 绑定0.0.0.0，解决端口不生效、宿主机无法访问的问题
ENV ASPNETCORE_URLS http://0.0.0.0:5000;https://0.0.0.0:5001
# 启动命令
ENTRYPOINT ["dotnet", "watch", "run", "--no-restore"]

3. 配置.dockerignore文件 #

避免本地无关文件和容器内文件冲突，减少构建耗时：

**/bin/
**/obj/
**/node_modules/
**/.git/
**/.idea/
**/.vscode/

4. 容器启动配置 #

4.1 单容器docker run命令启动 #

docker run -it --rm -p 5000:5000 -p 5001:5001 -v $(pwd):/app 你构建的镜像名

• -v $(pwd):/app参数将本地项目根目录（包含.csproj文件的目录）挂载到容器工作目录，本地代码修改会实时同步到容器内，同时解决找不到项目文件的问题
• 首次启动前建议先在本地执行一次dotnet restore，依赖包会同步到挂载目录，避免容器内下载依赖耗时过长

4.2 docker-compose配置（更推荐多服务场景使用） #

创建docker-compose.yml文件：

version: '3.8'
services:
  dotnet-webapp:
    build: .
    ports:
      - "5000:5000"
      - "5001:5001"
    volumes:
      - ./:/app
      # 匿名挂载bin和obj目录，避免本地和容器系统的编译产物冲突
      - /app/bin
      - /app/obj
    environment:
      - ASPNETCORE_ENVIRONMENT=Development

启动命令：docker-compose up --build #

5. 常见问题匹配解决方案 #

• 端口转发无效/宿主机无法访问服务：确认ASPNETCORE_URLS绑定地址为0.0.0.0，不要使用localhost或127.0.0.1
• 本地修改代码不触发热重载：确认已开启DOTNET_USE_POLLING_FILE_WATCHER=1环境变量，且目录挂载路径正确
• 找不到项目文件：确认挂载的本地目录是包含.csproj文件的项目根目录，不要挂载到上层目录

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