修复Composer网络传输过程中数据包损坏的技巧-composer-PHP中文网

应优先用composer install --no-cache --force-checksums强制远程重下并校验，而非删vendor；定位损坏包后手动清理~/.composer/cache/files/对应zip，再执行该命令。

修复composer网络传输过程中数据包损坏的技巧

Composer 报“corrupted package”或“unable to open archive”，基本不是网络丢包本身的问题，而是它下载的 ZIP 文件校验失败后拒绝继续——修复关键不在重试，而在让校验失败时立刻退出、强制重新拉取、跳过损坏缓存。

Failed to extract vendor/package: unable to open archive 怎么定位和清理

这个错误几乎一定指向 ~/.composer/cache/files/ 下某个 ZIP 文件损坏（比如下载中断、磁盘写入异常），Composer 校验 SHA256 失败后直接报错，且不会自动覆盖旧缓存。

先确认损坏包名：错误信息里带的路径如 vendor/symfony/console 就是线索，记下包名和版本号（如 symfony/console-6.4.0）
查缓存位置：composer config cache-dir，通常是 ~/.composer/cache/files/
进该目录，用 ls -l *symfony*console*.zip 找到对应 ZIP，rm -f 删除它
Windows 用户用 PowerShell：Remove-Item "$env:APPDATA\Composer\Cache\Files\symfony\console-*.zip"

为什么 --no-cache 和 --force-checksums 必须一起用

--no-cache 让 Composer 完全忽略本地缓存 ZIP，所有包都从镜像重新下载；--force-checksums 强制在解压前校验 SHA256，失败立即退出，不尝试解压损坏文件污染 vendor/。两者缺一不可。

Discussion Composer

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

下载

只用 --no-cache：仍可能读到已缓存但未被清掉的坏 ZIP（clear-cache 不总能清干净）
只用 --force-checksums：默认仍会先查缓存，校验失败才退，但坏 ZIP 已在缓存里，下次还会撞上
正确命令：composer install --no-cache --force-checksums
CI 中必须显式加，它不会继承配置，也不会写入 composer.json

installed.json 截断导致 Invalid argument supplied for foreach()

这个错误不是 ZIP 损坏，而是 vendor/composer/installed.json 被写到一半就中断（比如进程被 kill、磁盘满），JSON 结构断裂，Composer 启动时读它就崩。

直接删掉：rm -f vendor/composer/installed.json
再跑 composer install --no-plugins，让 Composer 重建该文件
如果删完还报错，说明 vendor/ 里已有部分包目录残留但不完整（比如只有 src/ 没有 composer.json），此时必须 rm -rf vendor
composer validate 只验 composer.lock，对 installed.json 完全无效

镜像源返回非法 JSON 导致元数据损坏怎么验证

换镜像后还报错？别急着删 vendor，先验证镜像本身是否在返回垃圾数据。Composer 把 packages.json 缓存在 ~/.composer/cache/repo/ 下，clear-cache 不清这里。

运行：curl -i https://mirrors.aliyun.com/composer/packages.json
检查三件事：HTTP 状态码是不是 200、Content-Type 头是不是 application/json、响应体开头是不是 {"packages":{
如果返回 301、502、text/html 或空内容，就是镜像元数据损坏
临时切回官方源：composer config -g repo.packagist composer https://repo.packagist.org，再手动删掉 ~/.composer/cache/repo/https---repo.packagist.org/