Manjaro系统下Watchman引发React Native客户端反复刷新求助
Manjaro 平台下 Watchman 触发 React Native 应用无理由自动刷新的解决方案
第一步:定位实际触发文件变更的来源
先运行以下命令开启Watchman的全量调试日志,找出反复触发爬取的具体文件:
- 清空现有Watchman监听状态,启动带日志输出的服务:
watchman watch-del-all watchman shutdown-server watchman --log-level=2 --log-file /tmp/watchman-debug.log - 按照正常流程启动React Native项目,等待一次自动刷新触发后,在新终端执行命令统计变更频次最高的文件路径:
输出的Top路径就是反复触发Watchman通知的文件,后续可以针对性做排除。grep "File changed" /tmp/watchman-debug.log | awk -F'path: ' '{print $2}' | sort | uniq -c | sort -rn | head -20
第二步:针对性修复已知场景的兼容问题
场景1:项目所在分区为btrfs文件系统
Manjaro默认安装多采用btrfs,旧版预编译的watchman-bin包存在btrfs事件误判问题,会把无实际内容变更的元数据修改识别为文件更新,触发反复爬取。
- 确认当前项目所在文件系统类型:
df -T . - 如果输出包含
btrfs字样,创建全局Watchman配置文件~/.watchmanconfig,写入以下内容:
配置说明:{ "btrfs_v2_ignore_new_events": true, "content_hash": true, "settle": 2000 }content_hash: true:Watchman不再仅依赖文件mtime/ctime判断变更,通过文件内容哈希校验跳过无实际修改的事件settle: 2000:收到文件变更事件后等待2秒,无新的连续变更才触发通知,避免频繁抖动
- 重启Watchman服务使配置生效:
watchman shutdown-server
场景2:Watchman无差别监听原生构建目录,触发构建文件变更
React Native项目的android、ios目录下存在大量Gradle/CocoaPods构建生成的临时文件,Watchman默认会爬取这些路径,一旦写入临时文件就会触发Metro重建bundle,而这些文件本身完全不需要被Metro监听。
- 在项目根目录创建
.watchmanconfig配置文件,写入以下排除规则:{ "ignore_dirs": [ "node_modules", ".git", "android", "ios", "build", "dist", ".metro-cache", "coverage" ], "ignore_files": ["*.log"] }
场景3:AUR预编译watchman-bin包与5.8内核inotify接口不兼容
2020年9月版本的预编译watchman-bin包基于更早的内核环境编译,在5.8内核下会出现inotify事件解析偏移,把内核返回的无意义事件识别为文件修改。
- 卸载预编译版本,替换为系统源码编译的Watchman包:
源码编译版本会自动适配当前系统的内核inotify接口,避免事件误判。yay -R watchman-bin yay -S watchman
第三步:兜底校验配置,避免异常反复触发bundle
如果上述配置调整后仍存在偶发自动刷新,在项目根目录的metro.config.js中加入Watchdog健康检查配置:
module.exports = { // 保留项目原有metro配置 watcher: { healthCheck: { enabled: true, interval: 30000, file: '/tmp/metro-watch-health.txt' } } }
该配置会每30秒校验一次文件监听状态,如果检测到连续无意义的变更触发,会自动重置监听服务,避免无反复重建bundle。
操作完成后的验证流程
所有配置调整完成后,清空全链路缓存再启动项目:
watchman watch-del-all rm -rf node_modules/.cache rm -rf /tmp/metro-* yarn start --reset-cache
等待应用完全加载后静置2分钟,如果没有循环出现的BUNDLE ./index.js日志,即代表问题解决。
内容的提问来源于stack exchange,提问作者Natetronn
相关产品推荐
相关产品推荐

