Composer升级后必须手动清缓存，否则易因旧元数据引发解析失败、版本错乱或install卡在Loading repositories；推荐组合操作：composer self-update && composer clear-cache --no-interaction。
Composer 升级本身不自动清理缓存，但升级后旧缓存可能引发兼容性问题——必须手动清，否则容易出现元数据解析失败、包版本错乱或 install 卡在 Loading repositories 阶段。
composer self-update 后要不要清缓存
要。新版 Composer（尤其是 2.5+ 到 2.6+）对 repo 元数据格式、HTTP 缓存策略和 vcs 仓库校验逻辑有调整。残留的旧版 cache/repo/ 下的 packages.json 可能含已弃用字段，导致 composer update 报 Could not load package xxx in http://repo.packagist.org 或静默跳过某些包。
- 升级命令本身不碰缓存目录，
composer self-update只替换二进制文件 - 升级后首次运行
composer update会尝试复用旧 repo 缓存，但解析失败时不会自动 fallback 或提示“缓存过期”，而是直接报错或降级行为异常 - 推荐组合操作：
composer self-update && composer clear-cache --no-interaction
为什么 clear-cache 在升级后更容易出 Corrupted cache file 错误
因为升级过程中 Composer 进程可能未完全退出，或 IDE（如 PHPStorm）后台仍在扫描 ~/.composer/cache/files/ 下的 ZIP 包，导致文件句柄被占用。此时 clear-cache 尝试删除正在被读取的文件，触发校验失败。
- 执行前先确认无残留进程：Linux/macOS 跑
lsof -D ~/.composer/cache，Windows 用任务管理器关掉所有php.exe - 若已报错，别重试——先等 10 秒再运行，或改用
rm -rf ~/.composer/cache/*（确保无进程占用后再手动删） - macOS 上若缓存目录是软链接到 NAS，
clear-cache可能因文件系统不支持原子删除而中断，建议先cp -r ~/.composer/cache /tmp/composer-cache-backup && rm -rf ~/.composer/cache/*
升级后只清 repo/ 不清 files/ 是否可行
可以，且常更安全高效。多数升级引发的问题集中在元数据层（repo/），而非包归档（files/）。
-
rm -rf ~/.composer/cache/repo/*能解决 90% 的“升级后拉不到新包”“镜像源切换失效”问题，且保留已下载的 ZIP 包，后续install不必重下大体积 dist 包 - files/ 下的 ZIP 文件格式未变，新版 Composer 仍可直接解压复用；但若你刚从 Composer 1 升到 2，files/ 里混有旧版 tar 格式包，建议一并清——用
find ~/.composer/cache/files -name "*.tar" -delete - 别动
~/.composer/cache/vcs/：Git 裸仓库结构稳定，清了反而让下次composer update多花几秒重建
CI/CD 中 Composer 升级 + 清缓存的可靠写法
不能只写 composer self-update && composer clear-cache——CI 环境默认无交互，clear-cache 会卡住；且 Docker 层缓存可能让 self-update 实际未生效。
- 强制非交互模式：
composer self-update --no-interaction && composer clear-cache --no-interaction - 为防 Docker 构建中缓存复用旧二进制，加校验：
composer --version | grep "2.6"，失败则curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer - 更稳做法：跳过本地缓存，直接用 --no-cache 安装依赖：
composer install --no-cache --no-interaction --prefer-dist，避免依赖任何缓存状态
真正容易被忽略的是：私有 Packagist 镜像或自建 Satis 服务，在 Composer 升级后可能要求更高 TLS 版本或 User-Agent 标头，此时清本地缓存没用，得同步更新镜像服务端配置——clear-cache 解决不了服务端协议不匹配的问题。
