process-timeout超时中断典型表现为执行composer install/update时卡在“Cloning into…”等子进程后静默退出并显示“The process timed out”，它仅终止子进程而不报PHP错误或写日志，常见于慢速Git拉取、大包解压或CI高IO场景，默认300秒，需区分其与http.timeout、内存限制、GitHub限流等干扰项。
process-timeout 超时中断的典型表现
执行 composer install 或 composer update 时卡在 “Cloning into…”、“Downloading…” 或某个脚本钩子（如 post-install-cmd）后突然退出，终端只显示 The process timed out，没有堆栈或具体错误——这就是 process-timeout 触发的静默中断。它不报 PHP 错误，也不写日志，只终止子进程。
常见诱因包括：从慢速 Git 服务器拉取私有包、解压含大量二进制资源的 dist 包、CI 环境中磁盘 IO 延迟高、或自定义脚本做文件扫描/生成操作。
- 默认值是 300 秒（5 分钟），但 Composer 不会告诉你它正在等什么——只会在超时后直接 kill 子进程
- 中断时可能伴随
proc_open(): fork failed，但这其实是内存不足的表象，不是 timeout 本身；两者常并发出现，需分开排查 -
--verbose模式下也看不到倒计时，只能靠观察命令是否“停住不动”超过 5 分钟来怀疑
三种配置方式优先级与实操要点
process-timeout 支持项目级、全局级、命令行临时覆盖三种方式，优先级从高到低为：命令行参数 > 项目 composer.json > 全局配置。但容易踩坑的是细节：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 命令行必须用
--timeout=7200（不是--process-timeout），且仅对当前命令生效；写成composer install --process-timeout=7200会被忽略 - 项目级配置写在
composer.json的"config"段里："process-timeout": 3600，改完需重新运行composer update --lock才能生效（否则旧 lock 文件仍走旧配置） - 全局配置用
composer config -g process-timeout 1800，但注意：如果项目里已设该值，全局设置完全不起作用——不是叠加，而是被覆盖 - 设为
0表示禁用超时，生产环境慎用；它不会让命令更快，只会让失败更难定位
为什么调高了还是超时？关键干扰项检查清单
调大 process-timeout 后仍中断，大概率是其他限制在“抢跑”——timeout 只是最后一道防线，前面还有更硬的瓶颈：
- PHP 内存限制：
php -d memory_limit=2G composer install必须放在最前，写成composer install -d memory_limit=2G完全无效 - 系统级 fork 限制：Linux 容器中
/proc/sys/kernel/pid_max或ulimit -u过低，会导致proc_open()直接失败，和 timeout 无关 - GitHub API 限流：没配
github-oauth.github.comToken，每小时 60 次匿名请求用完后，后续请求卡在 DNS 解析或连接建立阶段，看起来像超时，实际是 403/429 - 镜像源未清缓存：换了阿里云镜像但没执行
composer clear-cache，Composer 仍从 packagist.org 拉包，响应慢自然触发 timeout
CI/CD 中最稳妥的 timeout 设置组合
在 GitHub Actions、GitLab CI 等环境中，单靠调高 process-timeout 不够，必须配合环境控制：
- 固定内存上限：用
php -d memory_limit=2G，别用-1；CI 默认内存有限，-1容易被 cgroup 杀掉进程 - 显式传 Token：用
composer config github-oauth.github.com ${{ secrets.GITHUB_TOKEN }}（不加--global），避免权限错位 - 临时覆盖 timeout：在 job 步骤中写
COMPOSER_PROCESS_TIMEOUT=7200 composer install --no-interaction，比改配置文件更可控 - 禁用 xdebug：CI 中若启用了 xdebug（如某些 PHP 镜像默认开启），解析依赖会慢 5–10 倍，
php -d zend_extension= -d xdebug.mode=off必加
真正卡住的时候，process-timeout 往往只是症状，不是病根；先确认是不是网络、内存、认证这三块出了问题，再动 timeout。
