根本原因在于composer clear-cache不清理真正卡住update的三处:~/.composer/cache/repo/https---packagist.org/(过期元数据)、vendor/composer/installed.json(已装版本快照)和composer.lock(硬编码版本锁定),且项目级repositories配置会屏蔽全局镜像,导致元数据根本未从镜像站拉取。

composer update 清理缓存失败,根本原因不是“没清”,而是它压根不负责清理真正卡住更新的三处关键缓存——composer clear-cache 也一样,只动表层。
为什么 composer clear-cache 对 update 失效?
它只删 ~/.composer/cache/files/(ZIP 包)和 vcs/(Git 克隆),但 update 卡住通常是因为:
-
~/.composer/cache/repo/https---packagist.org/下的packages.json和provider-*.json过期,Composer 读这个决定“有哪些新版本” -
vendor/composer/installed.json记录着当前已装包的精确版本,依赖解析时直接复用 -
composer.lock硬编码了每个包的dist.sha256和版本,不删它,update就不会拉新
项目级 repositories 配置会彻底屏蔽全局镜像
哪怕你运行过 composer config -g repo.packagist https://mirrors.aliyun.com/composer/,只要项目 composer.json 里有 "repositories" 字段(哪怕内容是 {"packagist.org": false}),Composer 就会无视所有全局镜像,强制走官方源——这时 clear-cache 再干净也没用,因为元数据根本没从镜像站拉。
使用 template.yaml 定义创建 Spotify Backstage 软件模板,包含 Scaffolder 操作,包括 fetch:template、publish:github 和 catalog:register。通过其 REST API 管理 Backstage 软件目录。
- 检查命令:
composer config --list | grep repositories - 临时验证:
composer config --unset repositories(不加-g) - 删完再跑
composer update --dry-run -v,盯输出里是否出现Downloading https://mirrors.aliyun.com/composer/packages.json
metadata 缓存默认 15 分钟不过期,--refresh 才真刷新
Composer ≤ 2.4 不支持 --refresh,clear-cache 后仍可能复用旧 packages.json;≥ 2.5 可直接用:
-
composer update --refresh:丢弃所有元数据缓存,强制重拉镜像站的packages.json - 手动删缓存目录(等效):
rm -rf $(composer config --global cache-dir)/repo/https---mirrors-aliyun-com-composer - 注意路径拼写:URL 中的
.和/会被转义为-和---,别手敲错
最常被跳过的其实是 composer.lock。删了缓存、删了 installed.json,就剩它孤零零躺在那儿——Composer 一看锁文件没变,立刻认定“无需更新”,连远端都不去碰。这点在私有包或 nightly 版本发布后尤其明显。










