Composer 在并发 Jenkins 构建中会因共享 vendor/、composer.lock 或缓存目录导致死锁或崩溃，根本原因是多进程写入冲突；必须隔离 COMPOSER_HOME、COMPOSER_VENDOR_DIR 和 lock 文件写入权限，并避免 NFS 等共享存储的原子性缺陷。
Composer 在并发 Jenkins 构建节点上会因共享 vendor/ 目录或 composer.lock 文件争抢导致死锁或构建失败——这不是配置问题，而是默认行为在多进程写入时的必然结果。
为什么 composer install 在并发构建中会卡住甚至崩溃
多个 Jenkins agent 同时执行 composer install，若共用同一份源码（尤其是挂载的 NFS 或共享存储），就会竞争写入：vendor/ 目录被反复重建、composer.lock 被重写、缓存目录（如 ~/.composer/cache）跨进程冲突。常见现象包括：
file_put_contents(/path/vendor/autoload.php): failed to open stream: No such file or directory- 进程长时间阻塞在
Writing lock file或Generating autoload files Could not delete /path/vendor/composer/autoload_classmap.php
必须隔离的三个关键路径
不是“禁用缓存”或“加锁”就能解决，而是要让每个构建拥有独立的、不可交叉的运行上下文：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
COMPOSER_HOME：设为构建专属路径（如$WORKSPACE/.composer-cache），避免多个 job 共用~/.composer/cache -
COMPOSER_VENDOR_DIR：显式设为$WORKSPACE/vendor（而非默认相对路径），防止 symlink 或路径解析歧义 -
lock 文件写入权限：确保
composer.lock仅由单次构建生成；CI 中应禁用--no-lock且不运行composer update
Jenkins Pipeline 中安全调用 composer install 的写法
直接执行 composer install 是危险的，默认行为会尝试写 lock、清理 vendor、生成 autoload —— 这些动作在并发下不可重入：
- 用
composer install --no-scripts --no-dev --prefer-dist --optimize-autoloader减少副作用 - 在
sh步骤开头强制设置环境变量：export COMPOSER_HOME="$WORKSPACE/.composer-cache" COMPOSER_VENDOR_DIR="$WORKSPACE/vendor" - 确保
composer.lock已提交到仓库，且构建前不做任何修改（例如禁止git clean -fdx删除它） - 若使用 Composer 2.5+，可加
--no-plugins防止第三方插件引入额外文件操作
共享存储（NFS/Ceph）上的额外陷阱
即使做了路径隔离，NFS 的文件属性缓存和 rename 原子性缺陷仍会导致问题：
-
rename()在 NFS 上非原子，Composer 的vendor/替换（先建 tmp dir 再 rename）可能留下半成品目录 - 解决方案：改用
rsync --delete+cp -r模拟安装（需预构建 vendor tarball），或切换到本地 SSD 存储做 workspace - 检查
stat /path/to/vendor是否显示Remote I/O error或Stale file handle—— 这是 NFS 层面已损坏的明确信号
真正棘手的不是 Composer 本身，而是把“本地开发工具链”直接搬到分布式构建环境后，对文件系统语义的隐含假设全部失效。哪怕只漏掉一个 COMPOSER_HOME 环境变量，就可能让十个并发构建在凌晨三点同时 hang 在同一个 inode 上。
