答案是Composer 2.2+已废弃repo.packagist键名，必须用repositories.packagist.org并分两步配置type和url，且url末尾需加斜杠；项目级repositories会完全覆盖全局配置，生效前须执行composer clear-cache。
Composer 配置中文镜像后仍连接失败，90% 是配置未真正生效，而不是网络或镜像站问题——它不会报错，只会静默 fallback 到 packagist.org，然后因 DNS/TLS/CDN 问题卡住或超时。
为什么 composer config -g repo.packagist 看似成功却没用
这条命令在 Composer 2.2+ 中已完全废弃键名兼容性，写进去也静默忽略。真正生效的键是 repositories.packagist.org，且必须分两步设置：type 和 url，缺一不可。
-
composer config -g repositories.packagist.org.type composer—— type 值不能省，也不能写成composer-type或packagist -
composer config -g repositories.packagist.org.url https://mirrors.aliyun.com/composer/—— URL 必须以/结尾，少一个斜杠就会拼出/packages.json变成/composerpackages.json，直接返回 404 - 执行后务必验证：
composer config -g repositories.packagist.org应输出完整 JSON 对象，如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}；空、null或报错都说明失败
项目级 repositories 字段为什么会屏蔽全局镜像
只要项目根目录的 composer.json 中存在 "repositories" 字段（哪怕值是空数组 [] 或空对象 {}），Composer 就会彻底忽略全局配置，包括你刚配好的 repositories.packagist.org。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 检查命令：
grep -A 5 '"repositories"' ./composer.json，若输出非空，说明已被覆盖 - 临时清掉：
composer config --unset repositories（注意没有-g） - 安全追加镜像（不破坏私有源）：
composer config repositories.packagist.org type composer和composer config repositories.packagist.org url https://mirrors.aliyun.com/composer/，前提是repositories是对象结构；如果是数组，需先手动改为"repositories": {}再运行
怎么确认 Composer 实际请求的是镜像地址
别信日志里 “Loading repository” 这类模糊提示，也别只看 composer config 输出——唯一可靠的方式是看真实 HTTP 请求域名。
- 运行：
composer install -vvv 2>&1 | grep "Downloading.*packages.json" - 第一行输出应类似：
Downloading https://mirrors.aliyun.com/composer/packages.json - 如果出现
packagist.org或路径错误（如/composerpackages.json），说明配置未生效或被覆盖 -
composer diagnose不验证镜像连通性，它只连https://packagist.org，和你配的镜像无关
换源后仍 404 或 SSL 错误，该清理什么
composer.lock 文件硬编码了旧 provider 地址（例如 "https://packagist.org/p2/monolog/monolog.json"），换镜像后 Composer 仍优先尝试这个 URL，失败才 fallback——而新版 fallback 逻辑已被移除。
- 必须删掉：
vendor/和composer.lock - 必须执行：
composer clear-cache - 再重新运行：
composer install，否则旧地址缓存仍在起作用 - 某些镜像（如清华源）公网返回 HTML 页面（人机验证），Composer 解析失败；生产环境建议固定用阿里云或腾讯云源：
https://mirrors.aliyun.com/composer/或https://mirrors.cloud.tencent.com/composer/
最常被忽略的一点：CI/CD 或 Docker 构建中，composer config -g 写进了 /root/.composer/config.json，但实际运行命令的用户是 www-data 或 runner，根本读不到那个文件——这种情况下，项目级配置 + 提交 composer.json 才是唯一可靠的方案。
