Windows下Docker Compose运行React测试容器不热重载且强制退出问题

问题根因 #

Windows下Docker容器的文件系统监听机制存在兼容性问题，你给应用端设置的CHOKIDAR_USEPOLLING=true能生效，但react-scripts的测试脚本（npm test）有独立的监听逻辑——默认在CI模式下跑完就退出，再加上Windows的文件锁定、权限问题，导致文件变更时worker进程无法正常重启，直接被强制终止，进而出现'A worker process has failed to exit gracefully'报错。

修复步骤 #

1. 调整docker-compose测试服务配置 #

修改测试容器的环境变量、启动命令与挂载规则，确保监听模式正常开启：

services:
  # 保持原有React应用服务配置不变
  app:
    build: .
    command: npm start
    environment:
      - CHOKIDAR_USEPOLLING=true
      - WATCHPACK_POLLING=true
    volumes:
      - .:/app
      - /app/node_modules
    ports:
      - "3000:3000"
  
  # 修正后的测试服务配置
  test:
    build: .
    command: npm test -- --watchAll --watchPolling --no-watchman
    environment:
      - CHOKIDAR_USEPOLLING=true
      - CI=false  # 关键：禁用CI模式，让测试脚本保持监听状态
      - WATCHPACK_POLLING=true
    volumes:
      - .:/app
      - /app/node_modules  # 避免本地node_modules干扰容器内依赖
    user: "${UID:-1000}:${GID:-1000}"  # 匹配宿主用户ID，解决文件权限问题

2. 修正package.json测试脚本 #

将测试脚本改为基础监听模式，移除所有会强制退出的参数：

{
  "scripts": {
    "start": "react-scripts start",
    "build": "react-scripts build",
    "test": "react-scripts test",
    "eject": "react-scripts eject"
  }
}

3. 切换Docker后端到WSL2（Windows用户必做） #

Windows原生Docker后端的文件挂载监听问题较多，建议切换到WSL2后端：

• 打开Docker Desktop设置，进入"Resources"->"WSL Integration"，启用你正在使用的WSL发行版（如Ubuntu）
• 将项目迁移到WSL文件系统中（例如\\wsl$\Ubuntu\home\你的用户名\react-project），再用VS Code打开该目录

4. 强制禁用watchman（可选） #

如果问题仍存在，直接在测试命令中添加--no-watchman——容器内通常未安装watchman，反而会导致监听异常。

验证方法 #

1. 停止所有容器：docker-compose down
2. 重建并启动容器：docker-compose up --build
3. 修改App.test.js中的任意测试用例，观察测试容器是否自动重新运行测试且不退出。

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