直接删 ~/.composer/cache/files/ 下对应损坏的 ZIP 文件最有效,因为 composer clear-cache 仅校验哈希而不验证 ZIP 结构,导致复用已损坏文件仍报 Failed to extract 或 Corrupted zip file。

直接删 ~/.composer/cache/files/ 下对应损坏的 ZIP 文件最有效,不是跑 composer clear-cache,也不是换镜像。
为什么 composer clear-cache 常常没用
它会清空 files/、repo/、vcs/ 全部子目录,但 Composer 在后续 install 时仍可能跳过校验,直接复用已损坏的 ZIP —— 它只比对 dist.sha256 哈希值,不验证 ZIP 文件结构是否可解压。结果还是报 Failed to extract vendor/symfony/console 或 Corrupted zip file。
常见错误现象包括:
-
composer install -v卡在Extracting后无响应 - 反复出现
zlib_decode() error或The PHP file ... is corrupted - 同一包在不同机器上安装成功,但在某台机器上始终失败
怎么精准定位并删除坏 ZIP
别删整个 files/ 目录,先锁定具体包和版本:
- 盯住
composer install -v输出末尾,找Extracting vendor/xxx/yyy这类行,提取出包名(如monolog/monolog) - 查缓存路径:
composer config --global cache-dir(Linux/macOS 通常是~/.composer/cache,Windows 是%APPDATA%\Composer\Cache) - 进
files/子目录,模糊搜索:ls -l *monolog*monolog*.zip(Linux/macOS)
PowerShell 中:Get-ChildItem "$env:APPDATA\Composer\Cache\Files" -Recurse -Filter "*monolog*.zip" - 只删匹配的 ZIP 文件,保留
repo/和vcs/—— 它们不参与解压流程
删 ZIP 后还报错?必须同步清理锁文件和 vendor
因为 composer.lock 里硬编码了 dist.sha256,它和你刚删掉的旧 ZIP 对应;新下载的 ZIP 哈希值变了,但 Composer 仍拿旧哈希去比对,必然失败。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
必须同步操作:
- 备份:
cp composer.lock composer.lock.bak - 删干净:
rm -rf vendor composer.lock(Linux/macOS)或rd /s /q vendor & del composer.lock(Windows) - 重装:
composer install --no-cache --prefer-dist——--no-cache是关键,禁用本次所有缓存查找
容易被忽略的点:临时目录空间和权限
很多“解压失败”根本不是缓存问题,而是系统 /tmp(Linux/macOS)或 %TEMP%(Windows)满了。Composer 默认把 ZIP 下载、解压、重命名全放这儿做,峰值占用可能是 vendor 大小的 2–3 倍。
检查方式:
- Linux/macOS:
df -h /tmp - Windows:
dir %TEMP%
解决办法:
- 改临时目录:
export TMPDIR="/path/to/big/disk/tmp",再mkdir -p "$TMPDIR" && chmod 777 "$TMPDIR" - 删缓存中途报
Permission denied?说明有残留composer进程正锁着文件,先ps aux | grep composer杀掉










