直接重试往往无效，应先运行composer install --dry-run判断状态：大量skipped可续装，否则需清理vendor和缓存；--retries仅对composer 2.2+的dist包下载生效，且需配合http.timeout和connect-timeout调优；缓存损坏更常见，优先执行composer clear-cache并验证镜像配置。
直接重试往往无效，先看 composer install --dry-run 输出
报“Connection closed”“Operation timed out”或卡在 Downloading 阶段时，别急着连按 composer install。Composer 不会自动判断残留状态是否可用——它可能正在复用一个截断的 ZIP 或写坏的 installed.json。
运行 composer install --dry-run 是最快判断依据：
- 如果大量显示
Skipped vendor/package：说明已安装部分完整，直接重跑composer install即可续装 - 如果只显示
Installing vendor/package或直接报错（如Invalid argument supplied for foreach()）：vendor 状态已损坏，必须清理
--retries=5 为什么经常没用？关键看 Composer 版本和错误类型
--retries 参数从 Composer 2.2 才真正生效，且只对 dist 包（ZIP/TAR）下载重试，对 git clone 完全无效。更常被忽略的是：它不延长单次请求等待时间，只控制“重试轮数”。
常见失效场景：
- 旧版 Composer（如 2.1.x）静默忽略
--retries，实际仍是默认 3 次 - 错误是 cURL 28（超时），但
http.timeout还是默认 60 秒，重试 5 次 = 5×60 秒失败 - 卡在 TLS 握手或首字节响应慢，
connect-timeout太短（默认仅 10 秒），连接阶段就失败，根本走不到下载重试逻辑
临时生效：设环境变量 COMPOSER_NETWORK_TIMEOUT=300；永久生效：运行 composer config -g http.timeout 300 和 composer config -g connect-timeout 30。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
缓存损坏比网络问题更常见，composer clear-cache 应优先执行
报 Content-Length mismatch、Failed to extract 或反复卡在同一包，八成不是网络抖动，而是缓存里存了半截 ZIP —— Composer 下次会直接复用并校验长度，必然失败。
composer clear-cache 是低成本高收益操作：
- 清空
~/.composer/cache/files/下所有 ZIP 缓存，不影响vendor/或项目配置 - 执行后确认该目录为空，再重试，比换源或调超时更治本
- 若仍失败，加
--no-cache强制跳过本地缓存，排除中间污染
镜像源配置错误会导致“静默回退”，必须验证 URL 格式
国内用户最常踩的坑：镜像地址末尾多了一个 /，比如 https://mirrors.aliyun.com/composer/。Composer 会静默回退到 packagist.org，不报错，只无限卡在 downloading。
验证和修复步骤：
- 运行
composer config -g repo.packagist，输出必须是https://mirrors.aliyun.com/composer（结尾无斜杠） - 若有项目级配置覆盖全局，执行
composer config --unset repos.packagist.org - 同步延迟也可能导致 ZIP 404：用
composer install --no-cache --verbose查看失败 URL，再curl -I测试该 ZIP 是否返回 200
真正麻烦的不是重试次数，而是你不知道 Composer 此刻到底连的是谁、用的是哪个缓存、有没有在解一个坏文件——每一步都要靠 --dry-run、--verbose 和 clear-cache 去交叉验证，而不是凭感觉重试。
