Oracle Linux环境下Lerna watch无法检测文件变更问题求助

问题场景 #

我们有一个单仓库（monorepo）React应用，正在集成Lerna，环境信息：

• 操作系统：Oracle Linux OS
• Node.js版本：16.8.1
• React版本：17.0.1
• Lerna版本：7.1.1

执行lerna watch命令时，该环境无法检测JS文件变更，但在Node.js v18.16.1的Windows机器上可正常工作。

测试命令及输出 #

基础测试命令：

npx -c 'lerna watch -- echo \$LERNA_PACKAGE_NAME \$LERNA_FILE_CHANGES'

执行后无后续文件变更检测反馈；添加--verbose参数的命令及输出如下：

npx -c 'lerna watch --verbose -- echo $LERNA_PACKAGE_NAME $LERNA_FILE_CHANGES'

输出内容：

lerna notice cli v7.1.3
lerna verb packageConfigs Resolving packages based on package.json "workspaces" configuration.
lerna verb rootPath /home/XXXXXXXXXXXXXXXXXXXXXX
lerna info watch Executing command "echo $LERNA_PACKAGE_NAME $LERNA_FILE_CHANGES" on changes in 5 packages.
> NX   running with args: {"command":"echo $LERNA_PACKAGE_NAME $LERNA_FILE_CHANGES","projectNameEnvName":"LERNA_PACKAGE_NAME","fileChangesEnvName":"LERNA_FILE_CHANGES","includeDependentProjects":false,"projects":["XXXXXX","XXXXXX","XXXXXX","XXXXXX","XXXXXX"],"verbose":true}
> NX   starting watch process
> NX   watch process waiting...

解决步骤 #

1. 修复Node.js版本兼容性 #

Lerna 7.x依赖的文件监听底层库（如chokidar）在Node.js 16早期版本存在兼容性问题，建议：

• 升级Node.js到16.x最新稳定版（如16.20.2），或直接对齐Windows环境的18.x版本
• 使用nvm快速切换版本：

  nvm install 16.20.2
  nvm use 16.20.2
  

2. 调整系统文件监听配额 #

Oracle Linux默认的inotify监听配额可能不足，导致无法捕获文件变更：

• 临时调整并生效配置：

  echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.conf
  sudo sysctl -p
  

• 验证调整结果：

  cat /proc/sys/fs/inotify/max_user_watches
  

3. 显式指定Lerna监听规则 #

Lerna 7.x基于NX运行，可能存在默认过滤规则导致漏检：

• 显式指定监听JS文件模式：

  npx -c 'lerna watch --include "**/*.js" -- echo \$LERNA_PACKAGE_NAME \$LERNA_FILE_CHANGES'
  

• 检查根目录nx.json（若存在），确保未配置过严的文件忽略规则

4. 确认仓库目录权限 #

确保当前用户对仓库目录有完整读写权限：

• 检查目录权限：

  ls -ld /home/XXXXXXXXXXXXXXXXXXXXXX
  

• 调整权限（若不足）：

  sudo chown -R $USER:$USER /home/XXXXXXXXXXXXXXXXXXXXXX
  

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