Docker容器中NestJS的TypeScript编译器无法热重载问题

问题根源 #

1. start:debug命令未启用文件监听：NestJS的start:debug仅默认开启调试模式，若未添加--watch参数，不会监听文件变化触发热重载。
2. Docker卷挂载的文件监听限制：Windows/macOS的Docker Desktop环境中，容器内的inotify无法直接感知宿主机文件变化，需启用轮询模式。
3. 开发阶段冗余预编译：Dockerfile中RUN npm run build属于生产环境步骤，提前编译会干扰热重载的实时编译逻辑。

具体修复步骤 #

1. 更新package.json启动脚本 #

确保start:debug包含--watch参数，同时指定调试端口绑定所有网卡，方便宿主机访问：

"scripts": {
  "start:dev": "nest start --watch",
  "start:debug": "nest start --debug 0.0.0.0:9229 --watch",
  // 其他脚本保持不变
}

2. 调整Dockerfile开发阶段 #

移除开发阶段的预编译步骤，热重载会实时处理代码编译：

FROM node:18 AS development

WORKDIR /usr/src/app

COPY package*.json ./

RUN npm install

# 移除冗余的预编译命令：RUN npm run build
COPY . .

EXPOSE 3000
EXPOSE 9229

FROM node:18 as production
# 生产阶段配置保持不变...

3. 启用文件轮询（Windows/macOS用户必做） #

由于Docker文件共享不支持inotify，需强制热重载工具使用轮询检测文件变化，二选一即可：

• 方式一：修改nest-cli.json配置

{
  "compilerOptions": {
    "watchOptions": {
      "watchFile": "dynamicPriorityPolling",
      "watchDirectory": "dynamicPriorityPolling",
      "excludeDirectories": ["node_modules", "dist"]
    }
  }
}

• 方式二：直接在启动脚本中添加参数

"start:debug": "nest start --debug 0.0.0.0:9229 --watch -- --poll"

4. 验证docker-compose卷配置 #

当前卷挂载逻辑正确，无需修改，确认以下配置存在：

volumes:
  - .:/usr/src/app
  - /usr/src/app/node_modules

该配置会将宿主机代码目录挂载到容器，同时保留容器内的node_modules避免被宿主机覆盖。

测试修复 #

执行以下命令重启容器，修改任意TypeScript文件后查看容器日志，确认热重载触发：

docker-compose down
docker-compose up --build

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