Docker环境下NestJS热重载功能失效问题求助

核心原因分析 #

NestJS热重载失效主要涉及文件系统事件传递和容器内依赖缺失两个核心问题：

1. Alpine镜像默认未安装inotify-tools，而NestJS依赖Linux的inotify机制监听文件变化；
2. 跨系统（Windows/macOS → Linux容器）的文件系统事件可能无法被容器内的ts-node-dev正确捕获；
3. 默认热重载配置可能未覆盖挂载目录的文件变化逻辑。

解决方案 #

方案1：安装inotify-tools到Docker镜像 #

修改Dockerfile的development阶段，添加inotify-tools安装命令，补全文件系统监听依赖：

###################
# BUILD FOR LOCAL DEVELOPMENT
###################

FROM node:18-alpine As development

# 安装文件系统监听依赖
RUN apk add --no-cache inotify-tools

WORKDIR /usr/src/app

COPY --chown=node:node package*.json ./

RUN npm ci

COPY --chown=node:node . .

USER node

方案2：强制热重载使用轮询模式 #

修改docker-compose.yml的启动命令，添加--poll参数让ts-node-dev主动轮询文件变化，绕过系统事件传递障碍：

version: '2.13.0'
services:
  api:
    build:
      dockerfile: Dockerfile
      context: .
      target: development
    volumes:
      - .:/usr/src/app
      - /usr/src/app/node_modules
    # 添加--poll参数强制轮询文件变化
    command: npm run start:dev -- --poll
    ports:
      - 3000:3000

或者直接修改package.json的启动脚本：

"scripts": {
  "start:dev": "nest start --watch --poll"
}

方案3：验证卷挂载权限 #

确保本地目录文件权限与容器内node用户一致，避免因权限问题导致文件变化无法被读取：

1. 查看容器内node用户的UID/GID：docker exec -it <容器ID> id node
2. 调整本地文件权限：sudo chown -R <UID>:<GID> ./

验证步骤 #

1. 重新构建镜像：docker compose build
2. 启动容器：docker compose up
3. 修改src/main.ts并保存，观察容器日志是否出现[Nest] ... Reloading...的提示

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