NX Daemon无法启动/无法检测代码变更问题求助

问题现象 #

在Docker容器搭配VS Code Dev Container的环境中，运行yarn nx serve appName时提示NX Daemon is not running. Node process will not restart automatically after file changes.，应用可正常启动但代码变更需手动重启服务。已尝试nx reset、在nx.json添加"useDaemonProcess": true、升级至NX 19.6.1、重装依赖、卸载NX Console插件等操作，NX Daemon显示运行但仍无法检测代码变更，日志显示监听器处理输出目录变更但无作用。

解决方法 #

1. 调整容器内inotify监听上限 #

容器内默认的inotify监听文件数量上限可能不足以支撑NX的文件监听需求：

• 进入Dev Container终端，执行以下命令查看当前上限：

  cat /proc/sys/fs/inotify/max_user_watches
  

• 如果数值低于524288，临时调高：

  echo 524288 | sudo tee /proc/sys/fs/inotify/max_user_watches
  

• 要永久生效，可在docker-compose.yml中添加sysctl配置：

  services:
    your-service:
      sysctls:
        - fs.inotify.max_user_watches=524288
  

  或者在Dockerfile中添加：

  RUN echo "fs.inotify.max_user_watches=524288" >> /etc/sysctl.conf && sysctl -p
  

2. 强制NX使用轮询模式监听文件 #

容器内挂载的文件系统可能无法传递原生文件变更事件，启用polling模式可绕过这个问题：

• 在项目根目录的nx.json中添加watch配置：

  {
    "watchOptions": {
      "usePolling": true,
      "interval": 1000
    }
  }
  

• 保存后执行nx reset，再重新启动服务。

3. 指定NX Daemon的Socket路径 #

NX Daemon默认使用的socket路径可能因容器权限或挂载问题无法正常通信：

• 在Dev Container的终端中设置环境变量，指定一个容器内可访问的绝对路径：

  export NX_DAEMON_SOCKET_PATH=/tmp/nx-daemon.sock
  

• 停止现有Daemon并重启：

  yarn nx daemon stop
  yarn nx daemon start
  

• 再启动应用服务：yarn nx serve appName

4. 检查Dev Container的文件挂载配置 #

确保VS Code Dev Container的文件挂载配置支持实时同步：

• 打开.devcontainer/devcontainer.json，检查mounts字段，避免使用cached模式（可能导致文件变更延迟），根据宿主系统调整：
  • Linux宿主：使用delegated模式
  • Windows/macOS宿主：可尝试consistent模式
    示例配置：

  "mounts": [
    "source=${localWorkspaceFolder},target=/workspace,type=bind,consistency=delegated"
  ]
  

• 修改后重启Dev Container。

5. 启用Debug日志排查细节 #

通过Debug日志确认Daemon的运行状态和文件事件捕获情况：

• 启动服务时设置日志级别：

  NX_DAEMON_LOG_LEVEL=debug yarn nx serve appName
  

• 查看输出日志，重点关注是否有文件变更事件被捕获，以及Daemon连接相关的错误信息，针对性解决。

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