composer clear-cache仅清理~/.composer/cache/files/(ZIP包)、vcs/(Git镜像)和部分repo/(provider索引),不清理核心元数据repo/https---packagist.org/packages.json、vendor/composer/installed.json及composer.lock,故无法解决“拉不到新版本”或“Content-Length错误”等问题。

composer clear-cache 不会清掉真正卡住更新的元数据和锁文件,只清 ZIP 包和 Git 克隆缓存;它对 composer update 拉不到新版本、composer install 报 Content-Length 错误等场景基本无效。
clear-cache 实际清理哪些目录?
它只动 ~/.composer/cache/ 下的三个子目录:
-
files/:已下载的.zip和.tar归档(含哈希校验值) -
vcs/:Git clone 的本地镜像(如 GitHub 仓库的 shallow clone) -
repo/:仅部分 provider 索引(不包括https---packagist.org/下的核心 packages.json)
它完全不碰:vendor/、composer.lock、vendor/composer/installed.json、项目级 composer.json 配置,也不重读 repositories 设置。所以你改了镜像源却没生效,clear-cache 后照样走老路径。
为什么 clear-cache 后 update 还是“nothing to install or update”?
因为决定“有没有新版”的关键不在 files/,而在以下三处:
-
~/.composer/cache/repo/https---packagist.org/:存着过期的packages.json和provider-*.json,Composer 查版本全靠它 -
vendor/composer/installed.json:记录当前已装包的精确版本,解析依赖时直接读它 -
composer.lock:硬编码每个包的dist.sha256和source.reference,不删它,update就不会拉新
验证是否真刷新:运行 composer update --dry-run -v,日志里必须出现 Downloading https://packagist.org/packages.json,而不是 Reading /path/to/cache/packages.json。
使用 circleci/circleci-cli 和 circleci/orb-tools-orb SDK 来组合和验证 CircleCI Orbs。自动化 orb 打包、使用 conventional-changelog 进行语义化版本控制,并发布到 CircleCI Orb Registry。
遇到 Content-Length 不匹配或 Extracting 失败怎么办?
这类错误往往不是网络抖动,而是缓存文件损坏或权限异常:
-
Content-Length mismatch:先composer clear-cache,再确认$(composer config cache-dir)/files/下已无残留.zip;仍失败就加--no-cache --retry=3强制跳过所有缓存 -
Failed to extract或Corrupted zip file:进files/目录,按包名模糊搜索并删除对应 ZIP(如ls *laravel*framework*.zip),别删repo/或vcs/ - 清完缓存还报错?检查缓存目录权限:Linux/macOS 执行
rm -rf ~/.composer/cache && mkdir -p ~/.composer/cache && chmod 755 ~/.composer/cache;Windows 用户需手动给%APPDATA%\Composer\Cache子目录授“完全控制”权限
别信 --retry,它救不了损坏的缓存
--retry=3 只是重发整个 HTTP 请求,对已写坏的 ZIP 文件、过期的 provider 映射、或 composer.lock 里锁定的旧哈希值毫无作用。真正要做的,是分清楚问题类型:
- 网络层失败(SSL、代理、丢包)→ 临时关 TLS:
composer config -g disable-tls true+composer config -g secure-http false - 缓存内容损坏 → 手动删
files/中特定 ZIP,或整清repo/https---packagist.org/ - 本地状态锁定 → 必须删
composer.lock和vendor/composer/installed.json,否则连“要不要更新”都绕不过去
最常被忽略的是:删了 composer.lock 后,composer update 会重新解析全部依赖,如果项目里写了 "minimum-stability": "stable",而目标包只有 dev 版本,那即使 metadata 刷新了也看不到——这不是缓存问题,是约束本身在过滤。










