inotify watch 数量不足会导致镜像同步挂起，需通过调高 max_user_watches、精简监听路径、进程存活验证及轮询兜底三重机制解决。
inotify watch 数量不足导致同步挂起
Composer 本身不触发 inotify，但镜像同步脚本（如 rsync + inotifywait）常因系统 inotify watch 限额被耗尽而卡死。现象是 inotifywait 进程看似在运行，却不再响应文件变更——不是脚本 bug，是内核级资源耗尽。
- Linux 默认
/proc/sys/fs/inotify/max_user_watches通常为 8192，一个深度嵌套的 vendor 目录就可能占掉上千个 watch - 镜像服务若监听
/data/mirror/composer全路径，且包含大量子包（如 packagist.org 元数据），极易触顶 - 用
watch -n 1 'cat /proc/sys/fs/inotify/max_user_watches'查当前值；find /data/mirror/composer -type d | wc -l粗略估算目录数
如何安全扩容 inotify watch 限额
临时扩容只治标，必须配合监控与自愈逻辑。单纯写 echo 524288 > /proc/sys/fs/inotify/max_user_watches 在重启后失效，且未解决根本问题。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 永久生效需改
/etc/sysctl.conf：追加fs.inotify.max_user_watches=524288，再执行sysctl -p - 但更关键的是避免“全量监听”：把
inotifywait -m -r改成只监听变更最频繁的子路径，例如packages/和dist/，跳过.snapshot/和archived/ - 用
inotifywait -m -e modify,move,create,delete --format '%w%f %e' /data/mirror/composer/packages替代递归，减少 watch 占用
inotifywait 进程空窗期怎么防
进程崩溃重启时存在秒级无监听窗口，上游变更可能漏掉。不能只靠 pgrep inotifywait 判断存活，它不反映是否真在监听。
- 告警应基于 Prometheus 指标
absent(process_start_time_seconds{job="mirror-inotify"})，而非process_status{job="mirror-inotify"} == 0 - 自愈脚本检测到空窗后，先
killall inotifywait清残余，再用nohup inotifywait -m ... > /var/log/inotify.log 2>&1 &启动，确保 stdout/stderr 可追溯 - 启动后立刻用
inotifywait -t 1 -e modify /tmp/testfile 2>/dev/null || echo "not listening"做快速连通性验证
镜像同步脚本里怎么规避 inotify 依赖
过度依赖 inotify 容易单点故障。真正健壮的镜像服务应有 fallback 机制，尤其当 rsync 超时或 inotifywait 失效时。
- 每 5 分钟跑一次轻量级轮询：
find /data/mirror/composer/packages -name "*.json" -mmin -5 | head -n 1，有输出则触发同步 - 同步前加
rsync --dry-run验证目标可写、SSH key 有效、host key 未变，失败则记录HEAL:rsync-dry-run-failed到/var/log/mirror-heal.log - 若连续 3 次 inotify 无事件但轮询发现新文件，自动降级为全量扫描模式，并发邮件告警
max_user_watches，如果脚本没做事件消费速率控制，仍可能丢事件。真正的防线是监控 + 快速验证 + 轮询兜底，三者缺一不可。
