composer install报错大概率是缓存损坏所致，需清空~/.composer/cache/files/并用composer_cache_dir=/dev/null --no-cache安装；clear-cache有时无效因未清尽文件、持久卷挂载或文件被锁，应手动验证并强制清理。
Composer install 报错大概率不是网络或代码问题，而是缓存目录里存了损坏 ZIP、截断的 installed.json 或校验失败残留——这些文件不会自动清理，重试只会反复失败。
为什么 clear-cache 有时没用？
执行 composer clear-cache 看似清空了缓存，但实际可能只删了部分子目录（比如没清掉 ~/.composer/cache/files/ 下的损坏 ZIP），或者缓存路径被挂载为持久卷（CI 中常见），命令执行后文件还在。更隐蔽的是：某些杀毒软件或 IDE 会锁住 ZIP 文件，导致解压失败后缓存状态异常，clear-cache 不触发强制解锁。
- 验证是否真清空：
ls -l $(composer config --global cache-dir)/files/，输出应为空或仅含极少数小文件 - CI 中若用
cache: [~/.composer/cache]，别再额外COPY vendor/或cache: [vendor]，否则缓存污染会跨构建传递 - 临时绕过所有缓存干扰：用
COMPOSER_CACHE_DIR=/dev/null composer install --no-cache
“Failed to extract” 和 “corrupted archive” 怎么快速定位？
这两个错误几乎 100% 指向缓存中某个 ZIP 文件本身已损坏，而不是网络下载中断。Composer 在解压前会校验 SHA256，但不会主动检测 ZIP 结构完整性；一旦缓存里存了个半截文件，后续所有安装都会卡在这一步。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 先看报错里提到的包名，比如
vendor/symfony/console，去$(composer config --global cache-dir)/files/找对应目录，用unzip -t xxx.zip测试是否可读 - 如果测试失败，直接删掉整个
files/子目录，别只删单个 ZIP——损坏常成片出现 - Docker 构建中建议加
--no-interaction，避免因解压失败卡在交互式重试提示上
镜像源 + 缓存组合出问题，怎么验证是哪一层坏的？
中文镜像引发的 checksum mismatch 或 Content-Length mismatch 错误，本质是远程服务端返回了和官方不一致的包，而 Composer 默认复用本地缓存做校验。这时候清本地缓存没用，必须切回官方源验证。
- 临时跳过镜像：运行
COMPOSER_REPO_PACKAGES=https://repo.packagist.org composer install --no-cache - 若成功，说明镜像源确实返回了污染包；若仍失败，才是你本地缓存或权限问题
- 别信
composer config -g repo.packagist的输出——必须是完整 JSON 且 URL 末尾带/，否则配置静默失效
缓存问题最麻烦的地方在于它不报具体哪个文件坏了，只在解压或校验时突然崩。与其逐个排查，不如在 CI 脚本开头固定加一行 rm -rf $(composer config --global cache-dir)/files/，比依赖 clear-cache 更可控。
