必须执行composer clear-cache,否则配置无效;因Composer将packages.json快照缓存在~/.composer/cache/repo/https---repo.packagist.org/,即使删除镜像配置,update仍读旧元数据,导致版本错乱、lock更新失败或包找不到。

composer clear-cache 为什么必须执行
缓存不清理,配置就等于没改。Composer 把 packages.json 快照存在本地(路径类似 ~/.composer/cache/repo/https---repo.packagist.org/),哪怕你已删掉所有镜像配置,composer update 仍会从旧缓存读取元数据——结果就是包版本错乱、composer.lock 更新失败、甚至提示 Could not find package xxx。
常见表现:
-
composer config -g --unset repos.packagist执行成功,但composer require monolog/monolog --no-install -vvv日志里仍是mirrors.aliyun.com -
composer diagnose显示Repo packagist.org: https://packagist.org,但实际请求发往镜像域名
解决方式只有一步:composer clear-cache。它会清掉所有 dist 包、metadata 和 repo 缓存。别信“重启终端”“重装 Composer”这类无效操作。
临时文件不只是 cache 目录
除了 composer clear-cache 清的缓存,还有三类残留常被忽略:
-
vendor/目录:autoload 映射和 classmap 是基于旧镜像元数据生成的,不清掉可能引发Class not found或加载错误 -
composer.lock:它记录的是上次解析时的包 URL 和哈希值;若未更新,composer install仍会尝试从镜像地址拉取 dist 包 - 环境变量残留:
COMPOSER_REPO_PACKAGIST优先级高于任何配置,Linux/macOS 下用unset COMPOSER_REPO_PACKAGIST,Windows 下用set COMPOSER_REPO_PACKAGIST=
推荐组合清理命令(在项目根目录运行):
composer clear-cache<br>rm -rf vendor/<br>rm composer.lock
之后再跑 composer install,才是干净的官方源重建流程。
验证是否真走官方源,只看日志不看配置
别依赖 composer config -g repos.packagist 的输出是否为空——它只能说明字段删了,不能证明请求没被劫持。真正有效的验证方式是触发一次真实网络请求:
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 运行
composer require monolog/monolog --no-install -vvv - 滚动日志,找以
Downloading开头的行 - 正确应为:
Downloading https://repo.packagist.org/packages.json - 如果出现
mirrors.huaweicloud.com、mirrors.tuna.tsinghua.edu.cn或任何非repo.packagist.org的域名,说明某层配置或缓存仍有残留
注意:这个验证必须在 clear-cache 之后做,否则看到的仍是缓存里的旧 URL。
项目级 repositories 字段残留最隐蔽
很多人删完全局配置,却忘了当前项目 composer.json 里还留着 "repositories"。只要这个字段存在(哪怕内容是空对象 {} 或 "packagist.org": false),Composer 就不会 fallback 到默认源。
检查方法:
- Linux/macOS:
grep -A 5 '"repositories"' composer.json - Windows:
findstr /n "repositories" composer.json - 或直接打开
composer.json搜索repositories
安全清理方式(不破坏私有源):
- 如果只想还原 packagist 部分,运行:
composer config --unset repositories.packagist.org(不加-g) - 如果整个
repositories块都只是镜像配置,运行:composer config --unset repositories - 手动编辑时,千万别留
"repositories": {}——这等同于显式禁用所有源
删完立刻验证:composer config repositories 应返回 Key "repositories" does not exist。










