Composer国内镜像配置常见错误及排查-composer-PHP中文网

配置未写入成功，因键名repo.packagist、type值composer、https末尾斜杠三者缺一即静默失效；验证须输出完整json如{"type":"composer","url":"https://mirrors.aliyun.com/composer/"}。

composer国内镜像配置常见错误及排查

composer config -g repo.packagist 输出为空或不是完整 JSON

这说明配置根本没写进去，不是“生效慢”，是压根没命中 Composer 的识别规则。Composer 2.0+ 对键名、type 值、URL 格式三者有硬性校验，缺一即静默忽略。

必须同时满足：

repo.packagist 是唯一合法键名（单数、全小写、不能是 repos.packagist 或 packagist.org）
第二个参数必须显式为 composer（这是 type 值，不是可选注释）
URL 必须以 https:// 开头，且末尾带斜杠，例如 https://mirrors.aliyun.com/composer/
命令必须加 -g，否则只改当前项目，不作用于全局

验证方式只有一种：composer config -g repo.packagist 输出必须是类似 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 的完整 JSON 对象。空、null、字符串 URL、或报 Key not found，都说明失败。

明明配了镜像，-vvv 日志里还在请求 packagist.org

这不是网络问题，是配置被更高优先级的设置覆盖了。Composer 的源加载顺序是：项目级 composer.json 中的 repositories 字段 > 全局配置 > 默认源。只要项目里有 "repositories"，全局镜像就彻底失效，且不提示。

快速排查：

进项目目录，运行 composer config repositories，看 packagist.org 对应的 url 是什么
用 grep -A5 '"repositories"' composer.json 检查是否存在该字段（包括空数组 []、空对象 {}、甚至 "packagist.org": false）
临时清除：执行 composer config --unset repositories（注意无 -g），再跑 composer install -vvv

特别注意：Laravel 等脚手架生成的模板常自带空 "repositories": {}，它会直接屏蔽全局配置。

curl 测试镜像地址返回 404 或超时

Composer 不报错，但你实际发不出请求——这一步卡在 DNS 或 URL 拼写上，和 PHP 配置完全无关。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

先确认基础连通性：

运行 ping mirrors.aliyun.com，若返回 unknown host，说明 DNS 解析失败
运行 curl -I https://mirrors.aliyun.com/composer/packages.json，返回 HTTP/2 404 多半是 URL 少了末尾 /；返回 Could not resolve host 就是纯 DNS 问题
绕过 DNS 测试： curl --resolve mirrors.aliyun.com:443:223.5.5.5 https://mirrors.aliyun.com/composer/packages.json -I，能返回 200 就证实是 DNS 污染

常见拼写错误：

清华源必须是 https://mirrors.tuna.tsinghua.edu.cn/composer/，漏掉 /composer/ 或多写 /composer 都会 404
已下线源如 https://packagist.phpcomposer.com 会返回 HTML 页面，curl -I 显示非 200 OK 就别再用