Composer卡在Downloading(0%)或反复失败，根本原因是curl连接被中间设备切断后静默重试失败，而非等待；需清理污染状态、换国内镜像源（如阿里云）并清缓存，而非单纯调高超时。
Composer 没有“断开重连”机制，所谓修复，本质是判断中断位置、清理污染状态、换源绕过网络阻塞——直接重试只对瞬时网络抖动有效，其他情况硬等只会反复报错。
为什么 composer install 卡在 Downloading(0%) 或反复失败
这不是 Composer 在“等待”，而是 curl 层连接被中间设备（如运营商 NAT、防火墙）切断后，静默重试失败并卡住。常见表现包括：cURL error 28: Operation timed out、failed to open stream: Connection refused、或进度条停在某个 provider-*.json URL 上不动。
根本原因不是网速慢，而是默认超时太短（300 秒）、未启用长连接、且直连 packagist.org 在国内链路不稳定。PHP 的 default_socket_timeout 对 Composer 无效，它走的是自己的 cURL 配置。
- 运行
composer install -vvv，末尾若反复出现连接类错误，基本可确认是网络层问题 - 临时验证镜像是否生效：执行
curl -I https://mirrors.aliyun.com/composer/，应返回200 OK - 别信“再等等”，Composer 不会自动降级协议或切换备用源，除非你显式配了多个 repo
哪些错误必须删 vendor + 清缓存才能解决
一旦 ZIP 下载不完整、校验失败、或 vendor/composer/installed.json 被截断，Composer 就无法信任当前状态，重试只会循环报错。
典型错误包括：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
Failed to extract vendor/package-name: unable to open archive→ ZIP 损坏 -
The zip extension and unzip command are both missing→ 实际是上一步 ZIP 已损坏，解压器只是报错载体 -
Invalid argument supplied for foreach()→installed.json文件为空或 JSON 结构断裂 - 反复卡在同一包、同一百分比，且
-vvv显示下载后立即校验失败
此时必须按顺序执行：
-
rm -rf vendor（Linux/macOS）或rmdir /s vendor（Windows） -
composer clear-cache（清掉 ~/.composer/cache 或 %APPDATA%\Composer\Cache 中的坏 ZIP） -
composer install（重新从头拉取）
换镜像源比调任何参数都管用
国内用户约 80% 的“中断”问题，根源是直连 packagist.org 或 GitHub API 失败，不是 Composer 逻辑缺陷。阿里云、腾讯云镜像做了 HTTP/2、CDN 缓存和 TLS 加速，实测成功率提升 3～5 倍。
- 全局配置（推荐）：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 验证是否生效：
composer config -g repo.packagist应输出镜像地址，不是packagist.org - 私有包需单独配
repositories，镜像源默认不代理私有仓库 - 临时切源测试：
composer install --repository=https://mirrors.aliyun.com/composer/
换源后，--retry=3 和 --prefer-dist 才真正起效；否则 retry 只是在重复失败路径。
重试前该检查的三个隐藏状态
很多人重试失败，是因为忽略了这些非报错但致命的状态：
-
composer.lock是否被 Git 标为 modified？尤其注意 Windows/Linux 换行符差异导致的“已修改但没变”假象 - 当前工作目录是否为项目根目录？
vendor/autoload.php找不到 90% 是路径问题，不是没装好 - 磁盘是否写满？Composer 会在
vendor/下建临时 ZIP，空间不足会导致解压中断、installed.json截断
真正麻烦的不是网络断开本身，而是它留下的半成品目录、损坏的缓存 ZIP、或被截断却仍存在的 installed.json —— 这些不会报错，但会让后续所有命令行为异常。
