如何在Composer镜像中处理 vendor 压缩包损坏的情况-composer-PHP中文网

“failed to extract vendor/package”表示zip包本身损坏，需先执行composer clear-cache清缓存、再删vendor、加--no-cache重装，并验证镜像配置是否生效。

如何在composer镜像中处理 vendor 压缩包损坏的情况

Failed to extract vendor/package 是 ZIP 本身坏了

这不是网络中断或权限问题，而是 ~/.composer/cache/files/ 里那个 ZIP 文件校验失败了——Composer 下载后会用 SHA256 校验，不匹配就拒绝解压，且不会自动重试。错误典型如：Failed to extract vendor/symfony/console: unable to open archive 或 Content-Length mismatch。

别只删 vendor/：缓存里的坏 ZIP 还在，重装时照样被读取
先运行 composer clear-cache，再确认缓存目录是否真清空：ls -la $(composer config --global cache-dir)/files/
若只某个包反复出错（比如 monolog/monolog），可精准清理：rm -rf $(composer config --global cache-dir)/files/monolog/monolog
Windows 用户注意缓存路径是 %APPDATA%\Composer\Cache，不是 ~/.composer/cache

加 --no-cache 才算真正重拉

composer install 默认优先走本地缓存，即使你刚清过 cache，也可能因残留元数据或并发写入导致跳过下载。必须显式禁用缓存逻辑。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

composer install --no-cache 是关键：它绕过所有缓存查找，强制从镜像源重新拉 ZIP 并校验
CI/CD 中光靠 --no-cache 不保险——流水线常挂载持久化缓存目录，得配合环境变量：COMPOSER_CACHE_DIR=/dev/null composer install --no-cache
如果仍卡在同一个包，说明镜像源该版本 ZIP 确实损坏或已下线，运行 composer show vendor/package 查当前可用版本，必要时手动调整 composer.lock 中的 version 字段

镜像配置失效会让损坏更难排查

你以为在走国内镜像，实际请求发到了 packagist.org，结果下载慢、中断、校验失败——而错误日志里根本不会提示“正在从 packagist.org 拉取”。

Composer 2.2+ 已废弃 repo.packagist，必须用 repositories.packagist.org.type 和 repositories.packagist.org.url 两行设置
项目级 "repositories" 字段会完全屏蔽全局镜像配置，检查命令：grep -A 5 '"repositories"' ./composer.json
验证真实请求地址：Linux/macOS 可用 strace -etrace=network composer install 2>&1 | grep 'connect'，看连接 IP 是否指向镜像服务器
镜像服务异常（如返回 HTML 页面或卡住）比 ZIP 损坏更隐蔽，先 curl -I https://mirrors.aliyun.com/composer/packages.json 确认 HTTP/2 200