自动化部署中composer卡住或报processtimedoutexception，根本原因是默认超时太短、ci资源受限与镜像未生效三重叠加；必须同时调高process-timeout（推荐1200）、禁用packagist.org回源、强制--prefer-dist，否则仅延长timeout只会延迟失败。
自动化部署中 Composer 卡住或报 ProcessTimedOutException，不是网络“连不上”，而是默认超时太短 + CI 环境资源受限 + 镜像未生效三重叠加；必须同时调高 process-timeout、禁用 fallback、强制 --prefer-dist，否则光加 timeout 只是让失败来得更晚。
看 -vvv 输出最后一行，精准定位卡在哪一步
在 CI 脚本里加 composer install -vvv，盯住最后几行：
- 停在
Resolving dependencies：DNS 解析失败，http.timeout完全无效，要换/etc/resolv.conf的 nameserver 或用dig packagist.org @8.8.8.8验证 - 停在
Downloading https://...：HTTP 下载慢，该调http.timeout（推荐 600）和镜像源 - 停在
Executing command（如git clone）：子进程超时，process-timeout才管用（推荐 1200） - 停在
Generating autoload files后无响应：不是网络问题，是 WSL2/NTFS/Docker 卷 symlink 解析慢或 PHPopcache.enable_cli=0
CI 环境必须设的三个配置
只改 composer.json 或临时加 --timeout 不够稳，容器每次重建都会丢配置。必须用环境变量 + 全局 config 组合：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 强制国内镜像并禁用官方源回退：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，再加composer config -g repos.packagist.org false - 全局延长总耗时：
COMPOSER_PROCESS_TIMEOUT=1200（环境变量比--timeout更可靠，能覆盖插件启动的子进程） - 强制 dist 包，跳过所有
git clone：--prefer-dist（尤其防私有仓库硬编码成git@导致卡死）
http.timeout 和 process-timeout 别混用
这两个参数作用域完全不同，设错等于白调：
-
http.timeout：控制单次 HTTP 请求（含 DNS 查询、TLS 握手、首字节等待），默认仅 60 秒；下载大包（如laravel/framework）或镜像首字节延迟高时最先触发；设为600最常用 -
process-timeout：控制整个composer install命令生命周期，含解压、运行post-install-cmd、生成 autoloader；默认 300 秒，大项目建议1200 -
http-basic-timeout是 Composer 2.2+ 新增项，等效于http.timeout，旧版本不识别；别写成http.timeout拼错成http-timeout，那会静默失效
镜像配置最容易静默失败的三个点
换源命令看着成功，但实际没生效，90% 是以下原因：
- URL 少了末尾斜杠：
https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（会拼出非法路径/composerpackages.json） - 键名写错：
repo.packagist（单数 repo）✅，repos.packagist或repository.packagist❌ - 没清缓存：
composer clear-cache必须跟在换源命令后，否则还在用旧地址的失败记录
验证是否真生效：运行 composer config -g repo.packagist，输出必须是完整 JSON，如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。
