直接重试 composer install 总是失败，因Composer无断点续传且不校验缓存ZIP完整性，中断后残留半截文件导致反复校验失败；--no-cache不清理已写入的残缺dist包，--retries仅对2.2+版本dist下载生效，Git克隆等环节完全不重试。
Composer 遇到网络连接中断（比如 Connection lost、Connection reset by peer、Content-Length mismatch）时，不是简单重试就能解决的——它会复用损坏的缓存文件，卡在同一个地方反复失败。
为什么直接重试 composer install 总是失败
Composer 没有断点续传，也不校验缓存 ZIP 文件是否完整。一旦下载中途断开，vendor/composer/archives/ 或 $COMPOSER_HOME/cache/files/ 里就留下半截 ZIP，下次仍会读它并触发校验失败，直接报错退出。
-
--no-cache只跳过元数据（如packages.json），对已写入的残缺 dist 包完全无效 -
--retries在 Composer 2.2+ 才生效，且仅作用于 dist 下载阶段；Git 克隆、解压、写入等环节不重试 - Windows 用户执行
composer clear-cache后，还需手动删%LOCALAPPDATA%\Composer\Cache\files\，否则缓存清理不彻底
必须执行的三步清理动作
中断后不能只清 vendor 或只跑重试，要同步清除三个层面的状态：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 运行
composer clear-cache清掉所有缓存层级（含files/和repo/） - 删除项目级残留：
rm -rf vendor/ composer.lock（Linux/macOS）或rd /s /q vendor &&del composer.lock（Windows） - 确认
composer config -g repositories.packagist.org输出是你配的镜像地址（如https://mirrors.aliyun.com/composer/），且 URL 末尾带/；若为空，说明镜像没生效
让重试真正起效的配置组合
光清理不够，还要防止下一次又中断。关键参数必须一起调：
- 延长等待时间：
composer config -g http.timeout 600（单次 HTTP 请求最长等 10 分钟） - 放宽进程限制：
composer config -g process-timeout 1200（整个命令最长运行 20 分钟） - 禁用连接复用（对抗 NAT/防火墙 RST）：
CURL_OPTIONS="--no-keepalive"（Linux/macOS）或$env:CURL_OPTIONS="--no-keepalive"（PowerShell） - 临时强制走镜像（绕过项目级
repositories干扰）：composer install -vvv --repository=https://mirrors.huaweicloud.com/repository/php/
最常被忽略的隐性冲突点
即使你全局配了阿里云镜像，只要项目 composer.json 里写了 "repositories" 字段（哪怕只是空数组），Composer 就会完全屏蔽全局配置，回退到官方源或尝试读取错误路径。验证方法是运行 composer config repositories——输出非空，就必须删掉或注释掉项目里的该字段。
另外，curl.cainfo 在 php.ini 中指向的证书路径如果不存在或权限不对，也会导致看似“连接中断”，实际是 SSL 握手静默失败。用 php --ini 找到真实加载的 ini 文件，再检查该配置项是否有效。
