应精准删除损坏ZIP文件并同步清理vendor/和composer.lock:先用composer install -v定位包名,再进~/.composer/cache/files/搜索删除对应ZIP,最后rm -rf vendor composer.lock并运行composer install --no-cache --force-checksums。

定位损坏 ZIP 文件的路径
“Failed to extract” 类错误(比如 Corrupted zip file: monolog/monolog)本质不是网络问题,而是 ~/.composer/cache/files/ 下某个 ZIP 包损坏了。Composer 拿着坏文件去解压,校验失败就直接报错,不会重试或跳过。
关键动作是精准定位,不是清全量缓存:
- 运行 composer install -v,盯住输出末尾,找 Extracting 或 Downloading 后紧跟着的包名和版本(如 symfony/console v6.4.10)
- 查缓存根目录:composer config --global cache-dir(Linux/macOS 通常是 ~/.composer/cache,Windows 是 %APPDATA%\Composer\Cache)
- 进入 files/ 子目录,用包名模糊搜索 ZIP:
• Linux/macOS:ls -l *symfony*console*.zip
• Windows PowerShell:Get-ChildItem "$env:APPDATA\Composer\Cache\Files" -Recurse -Filter "*console*.zip"
只删对应 ZIP,别碰 repo/ 和 vcs/
repo/ 存的是包元数据(JSON),vcs/ 存的是 Git 克隆副本,它们不参与解压流程,删了反而会导致后续 composer update 重新拉取元数据,拖慢速度。
只删除匹配到的 ZIP 文件即可,例如:
- rm ~/.composer/cache/files/symfony/console/abc123def456.zip
- Windows:del "%APPDATA%\Composer\Cache\Files\symfony\console\abc123def456.zip"
注意:不要用 composer clear-cache,它会清空整个缓存,但 Composer 默认仍可能复用已损坏的 ZIP 哈希——校验失败照样卡住。
同步清理 vendor/ 和 composer.lock 才有效
只删 ZIP 不够。因为 composer.lock 里硬编码了 dist.sha256,它和你刚删掉的旧 ZIP 绑定。如果 vendor/ 和 composer.lock 还在,Composer 会继续拿这个哈希去比对本地缓存(哪怕 ZIP 已删),结果仍是校验失败。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
必须三步一起做:
- 备份:cp composer.lock composer.lock.bak
- 彻底清理:rm -rf vendor composer.lock(Windows:rd /s /q vendor & del composer.lock)
- 重装并强制校验:composer install --no-cache --force-checksums
• --no-cache 强制跳过本地 ZIP,走全新下载
• --force-checksums 让校验失败立刻退出,避免污染 vendor/
CI 环境中尤其容易漏掉 composer.lock
CI 流水线里常从 Git 拉取 composer.lock,如果它含旧源地址(比如指向已下线的私有镜像),即使你清了缓存、删了 vendor,composer install 仍会按 lock 文件里的 dist URL 去请求,结果超时或 404。这时候必须确保 composer.lock 是干净重建的——也就是上一步的“删 lock + --no-cache 重装”不可省略。
另外,composer remove 命令不能解决缓存 ZIP 损坏问题,它只改 composer.json 和 composer.lock,不碰缓存文件,也不触发重新下载校验。










