镜像未生效的首要原因是配置未落盘,需执行composer config -g repo.packagist确认输出为完整URL(如https://mirrors.aliyun.com/composer/),并清理provider缓存目录后验证show/why-not/--dry-run结果。

运行 composer config -g repo.packagist 确认镜像地址已写入全局配置
镜像没生效的首要原因是配置根本没落盘。执行 composer config -g repo.packagist,输出必须是完整 URL 字符串(如 https://mirrors.aliyun.com/composer/),不能是空、null 或格式错误的值。常见错误包括:
- 漏掉末尾
/,导致 Composer 无法拼接正确路径 - 误用
repos(复数)而非repo.packagist(单数 key) - 未加
-g参数,结果只写入当前项目而非全局,CI 环境下几乎无效 - 执行命令时当前用户与 Composer 运行用户不一致(如用
sudo配置,但普通用户运行composer update)
执行 composer clear-cache 并手动清理 provider 缓存目录
composer clear-cache 只清 ZIP 包和 dist 缓存,对元数据(packages.json、provider-*.json)基本无效。镜像同步延迟时,Composer 仍会读旧索引,导致 composer show 查不到新包或 why-not 输出过时冲突规则。
- 先查缓存路径:
ls -d ~/.composer/cache/repo/https---mirrors.aliyun.com-composer(Linux/macOS)或%APPDATA%\Composer\cache\repo\https---mirrors.aliyun.com-composer(Windows) - 直接删掉整个目录:
rm -rf ~/.composer/cache/repo/https---mirrors.aliyun.com-composer - 再跑一次
composer show packagist/support,检查source.url是否含镜像域名;若仍是packagist.org,说明镜像根本未生效
用 composer show 和 composer why-not 验证解析行为是否变化
配置是否真正影响依赖求解,得看命令输出是否反映新规则。关键不是“能不能连上”,而是“它用哪份元数据做推理”。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
-
composer show monolog/monolog应返回来自镜像源的版本列表,且source.url显示镜像地址 -
composer why-not monolog/monolog:3.5.0的输出长度和具体包名应比之前更丰富——如果仍只报两三个包,大概率还在读旧缓存 -
composer update --dry-run -v最后几行的 “Resolving dependencies” 日志中,URL 路径应出现mirrors.aliyun.com/composer,而非packagist.org
注意 composer diag 完全不验证镜像配置
composer diag 默认只测 https://packagist.org,无论你配了多少镜像,它都不会访问它们。看到 “Connection to packagist.org failed” 只说明本地网络基础能力异常,和镜像是否可用毫无关系。
- 别被
diag的输出误导,它对排查镜像问题毫无价值 - 真要验证镜像可用性,必须手动
curl -I https://mirrors.aliyun.com/composer/packages.json,确认 HTTP/2 200 和Last-Modified时间戳接近当前时间 - 所有依赖解析类问题(如版本装错、冲突报错不准)都必须跳过
diag,直奔show、why-not、--dry-run -v三件套
实际验证时最容易忽略的是 provider 缓存目录残留——它让 Composer 在“以为自己用了新镜像”的状态下,持续读取一周前的旧索引。每次换源后,删目录比重装 Composer 更有效。










