Composer本地缓存不会产生IO死锁，因其采用只读复用+单进程写入设计，无并发写、无锁机制；真正导致死锁的是并发写vendor/目录，应通过flock锁定composer.lock来解决。
Composer本地缓存本身不涉及运行时文件IO死锁，所谓“高可用保护机制”是误读——它没有锁、不并发写、也不需要防护。
为什么composer cache-dir不会产生IO死锁
Composer的缓存目录（cache-dir）是纯只读复用+单进程写入的设计：每次下载包后，它把ZIP或Git克隆结果按SHA哈希存进cache/files/或cache/vcs/，后续安装直接硬链接或解压，不修改已有文件。多个composer install进程可以同时读同一份缓存，但不会有进程去改它。
- 缓存写入只发生在
composer update或首次composer install时，且由当前进程独占完成 - 没有后台守护进程、没有定时清理线程、没有跨进程状态同步
- 即使两个CI job同时跑
composer install，它们都只读缓存，不会争抢写锁
真正会死锁的是vendor/目录，不是cache/
你遇到的“死锁”现象，大概率是并发composer install往vendor/写文件导致的混乱，和cache-dir无关。典型表现包括：The lock file does not contain the required package "xxx"、Class not found、vendor/里缺包或版本错乱。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 根本原因：
composer install不加锁，多个进程同时解析composer.lock并往vendor/写入，互相覆盖或中断 - 解决方案不是动
cache-dir，而是用flock ./composer.lock -c 'composer install'串行化install操作 -
cache-dir设成只读（cache-read-only: true）反而可能让并发安装更慢——每个进程都要重新下载，但依然不会死锁
cache-files-ttl和cache-files-maxsize不影响并发行为
这两个配置只控制缓存生命周期和空间回收，不参与任何同步逻辑：
-
cache-files-ttl（默认6个月）：决定ZIP包多久没被访问就进GC队列，GC本身是单次命令触发（composer clear-cache --gc），非自动后台任务 -
cache-files-maxsize（默认300MiB）：超出时删最旧文件，同样只在显式调用或--gc时发生 - 它们都不引入文件锁、不阻塞
install、不改变多进程行为
真正要防的不是缓存IO死锁，而是vendor/被多个进程同时写坏。别在cache-dir上找锁，flock必须落在composer.lock或项目根目录上——这是唯一能守住部署一致性的位置。
