换源后仍报错说明配置未生效,需用 composer config -g repo.packagist 验证输出是否为合法 JSON;若非预期值,则检查键名、URL结尾斜杠、type字段等;再通过 composer diagnose 和 composer install -vvv 确认实际请求地址,并清除缓存、lock 文件及 vendor 目录。

换源后依然报错,说明镜像地址本身没问题,问题出在配置没落进 Composer 的实际执行路径里——不是源不稳,是你根本没用上它。
看 composer config -g repo.packagist 输出是不是完整 JSON
这是唯一可信的验证方式。输出必须是形如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 的合法 JSON:
- 空、
null、"https://packagist.org"或报错 → 配置压根没写进去 - 键名写成
repos.packagist(多一个 s)或repositories.packagist.org→ 不识别,静默 fallback 到官方源 -
url缺少末尾/→ 请求路径拼错,比如变成/composerpackages.json,直接 404 -
type字段缺失或值不是"composer"→ Composer 不认这个源类型
运行 composer diagnose 确认 Repo packagist.org 地址是否匹配
composer diagnose 会输出一行:Repo packagist.org: https://mirrors.tuna.tsinghua.edu.cn/composer/。这一行的 URL 必须和 composer config -g repo.packagist 的输出完全一致(协议、域名、结尾斜杠缺一不可):
使用 circleci/circleci-cli 和 circleci/orb-tools-orb SDK 来组合和验证 CircleCI Orbs。自动化 orb 打包、使用 conventional-changelog 进行语义化版本控制,并发布到 CircleCI Orb Registry。
- 这里还是
https://packagist.org→ 全局配置被覆盖,重点检查项目级composer.json里的repositories字段 - Git Bash 下
diagnose显示空路径 → 换 PowerShell 或 CMD 再试,环境差异会导致输出异常 - 地址对了但下载仍慢 → 缓存没清,不是配置问题,
composer clear-cache必做
用 composer install -vvv 抓最后一行真实请求域名
日志里第一行出现的 Downloading https://... 才是 Composer 实际发出去的地址:
- 看到
packagist.org→ 项目级composer.json里有repositories,它优先级高于全局配置,直接屏蔽了你设的镜像 - 看到镜像域名但卡住 → 不是配置问题,是网络链路卡在 DNS / TLS / 代理环节,用
curl -I https://mirrors.aliyun.com/composer/单独测 - 停在
Executing command(比如git clone)→ 子进程超时,该调COMPOSER_PROCESS_TIMEOUT,不是http.timeout
删缓存、删 lock、删 vendor 是最常被跳过的三步
旧缓存里存着 packagist.org 的元数据,Composer 会继续按老地址去连;composer.lock 里记录的是原始 dist URL,不会自动重写为镜像地址:
- 必须执行
composer clear-cache,等提示All caches cleared.才算完 - 删掉
composer.lock和vendor/后再跑composer install,避免依赖解析阶段复用错误路径 - Windows 用户注意:IDE 或杀毒软件可能锁住
vendor/文件,关掉 PhpStorm/腾讯电脑管家再试
真正卡住的地方往往不在“换源”动作本身,而在缓存残留、项目级配置覆盖、或子进程超时这些隐性环节——盯着 -vvv 日志最后一行,比反复重试管用得多。

















