应优先用composer install --no-cache --force-checksums强制远程重下并校验，而非删vendor；定位损坏包后手动清理~/.composer/cache/files/对应ZIP，再执行该命令。
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）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “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/
最常被忽略的是缓存目录权限混乱、磁盘空间不足，或项目级 composer.json 里写了 "repositories": [] 导致全局镜像静默失效——这些比反复重试更值得先查。
