必须手动删除vcs/和repo/下对应缓存目录,因Composer不自动检测VCS地址变更,会复用旧裸仓库和元数据;还需执行composer update --no-cache --force-checksums确保拉取新源。

为什么改了 Git 仓库地址,Composer 还在拉旧仓库?
不是网络或权限问题,是 Composer 把旧 VCS 地址的裸仓库(vcs/ 下的 git 目录)和元数据(repo/ 下的索引)都缓存住了。它不会主动检测 URL 变更,只要本地有匹配的 vcs/ 目录,就直接复用——哪怕新地址已指向不同仓库、甚至已删除旧 repo。
必须手动删掉 vcs/ 对应目录,别指望 clear-cache
composer clear-cache 默认不删 vcs/ 子目录(出于性能考虑),而 VCS 缓存正是问题根源。正确做法是精准定位并删除:
- 先确认当前项目用的 VCS 源:运行
composer config --list | grep repositories,找到类似repositories.0.url的值,例如https://gitlab.example.com/group/pkg.git - 转成缓存路径:把协议+域名+路径中的
/全部替换为-,去掉末尾.git,如https---gitlab.example.com-group-pkg - 执行删除:
rm -rf $(composer config --global cache-dir)/vcs/https---gitlab.example.com-group-pkg - Windows 用户注意:
$(composer config --global cache-dir)在 PowerShell 中需加.Trim(),或直接写$env:APPDATA\Composer\Cache\vcs\https---gitlab.example.com-group-pkg
同步清理 repo/ 元数据,否则仍看不到新 tag
VCS 地址变了,但 Composer 还在读旧 repo/ 里缓存的 packages.json,导致 composer update 根本不请求新仓库的 tags 或 branches。必须连带清理:
使用 template.yaml 定义创建 Spotify Backstage 软件模板,包含 Scaffolder 操作,包括 fetch:template、publish:github 和 catalog:register。通过其 REST API 管理 Backstage 软件目录。
- 同样从
repositories.0.url推导 repo 缓存路径,但这次进repo/而非vcs/,例如$(composer config --global cache-dir)/repo/https---gitlab.example.com/ - 删掉整个子目录:
rm -rf后再跑composer update --dry-run -v,看到Downloading https://gitlab.example.com/packages.json才算生效 - 如果该私有源还配置了
type: "package"或通过 Satis 提供服务,也要检查repo/下是否还有其他对应路径(如含端口或子路径)
重装时加 --no-cache --force-checksums,跳过所有缓存干扰
只删缓存还不够,安装阶段仍可能复用残留 ZIP 或跳过校验。安全起见,重装命令必须带上:
-
--no-cache:强制跳过files/下任何 ZIP,全部重新下载 -
--force-checksums:校验失败立刻报错退出,不往vendor/写损坏内容 - 如果是全局插件(如
hirak/prestissimo),还要同步删掉~/.composer/composer.lock和~/.composer/vendor/下对应目录,否则锁文件里的旧 commit hash 会持续干扰
真正麻烦的从来不是“怎么删”,而是删漏了哪一层——VCS 缓存、repo 元数据、lock 文件、vendor 实体,四者缺一都会让 Composer 坚信“一切正常”,继续拉取早已失效的历史快照。










