Docker环境下Mocha --watch保存文件后不自动重跑测试如何修复

Mocha 10.x 版本的 --watch 模式默认依赖 Node.js 原生 fs.watch 监听文件变更，在 Docker 容器使用 bind mount 挂载宿主机目录的场景下，宿主机上的文件修改操作无法触发容器内的 inotify 事件，这是相同配置在裸机环境正常、容器内失效的核心原因。你当前使用的 nodemon 也存在同类监听失效的潜在风险。

按优先级选择即可：

• 方案1：开启Mocha轮询监听（改动最小，兼容性最好）
  轮询模式按固定间隔检查文件变更，不依赖inotify事件，完全适配Docker挂载场景。修改 .mocharc.tdd.js 配置，补充监听范围和轮询参数：

  module.exports = {
      "reporter": "dot",
      "watch": true,
      "watch-ignore": [],
      // 明确指定监听的文件范围
      "watch-files": ['src/**/*.js', 'test/**/*.js'],
      // 开启轮询适配容器环境
      "watch-options": {
          "usePolling": true,
          "interval": 500 // 轮询间隔单位为毫秒，500ms可兼顾响应速度和CPU占用
      },
      "file": 'test/common.js',
      "recursive": true
  };
  

  如果不想修改配置文件，也可以直接在启动命令中追加参数：

  npx mocha --config .mocharc.tdd.js --watch-files src/**/*.js,test/**/*.js --watch-options usePolling=true,interval=500
  

• 方案2：同步修复nodemon的容器监听问题
  你当前dev脚本使用的nodemon同样可能在容器内出现修改文件不重启的问题，给nodemon追加-L（legacy-watch）参数开启轮询即可：

  "dev": "npx nodemon -L --inspect=0.0.0.0:1080 src/index.js"
  

• 方案3：Docker挂载参数优化（可选，非100%生效）
  如果不想用轮询（轮询会产生少量固定CPU占用），可以在docker-compose的卷挂载配置中添加cached选项，在macOS、Windows端的Docker Desktop环境下，可提升原生文件系统事件的传递成功率：

  services:
    your-service-name:
      volumes:
        - ./:/app:cached
  

  该方案受宿主机操作系统、Docker版本影响较大，稳定性不如轮询方案，优先推荐前两个方案。

修改配置后重新执行npm run test:tdd，在宿主机上修改任意src或test目录下的JS文件，最长等待1秒即可看到Mocha自动重新执行测试，不会一直停留在ℹ [mocha] waiting for changes...状态。

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