一步步教你排查Composer镜像配置问题-composer-PHP中文网

composer全局镜像未生效是因为repo.packagist键名错误、缺composer类型值或url末尾无/，三者任一缺失即静默回退官方源；验证需composer config -g repo.packagist输出完整json且-vvv日志中get请求指向镜像域名。

一步步教你排查composer镜像配置问题

composer config -g repo.packagist 输出为空或报错

这说明全局镜像根本没写进去，不是网络慢，是配置压根没生效。Composer 2.x 对键名、type、URL 格式三者要求极严，漏一不可。

repo.packagist 必须是单数形式——写成 repos.packagist 或 packagist.org 都无效
第二个参数必须显式写 composer，不能省略、不能写空字符串、不能当注释用
URL 必须以 https:// 开头（内网 ECS 可用 http://），且末尾必须带 /：例如 https://mirrors.aliyun.com/composer/ ✅，https://mirrors.aliyun.com/composer ❌
Windows 用户执行后要重启终端，否则 shell 缓存旧配置，composer config -g repo.packagist 仍显示空

明明配了镜像，install 还卡在 “Loading composer repositories…”

这不是镜像地址慢，而是请求压根没发到镜像站——大概率被项目级 repositories 覆盖了。

Discussion Composer

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

下载

运行 composer config -g repo.packagist 和 composer config repo.packagist，对比两者输出：如果后者有值，说明项目 composer.json 里写了 "repositories" 字段，它优先级更高
执行 grep -A3 '"repositories"' composer.json，检查是否含 "packagist.org": false、空数组 [] 或硬编码了 https://packagist.org
只要 repositories 存在（哪怕只有一行注释），Composer 就忽略全局镜像；安全做法是删掉整个 repositories 字段，或确保首位是合法镜像对象：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}
已有 composer.lock 时，旧文件会固化包地址，务必连同 vendor/ 一起删掉再 composer install

curl 测试镜像地址返回 404 或非 JSON 响应

镜像 URL 格式错误或源已失效，会导致 Composer 静默 fallback 到官方源，你只会觉得“换源没用”。

手动测元数据接口：curl -I https://mirrors.aliyun.com/composer/packages.json，必须返回 HTTP/2 200 且 Content-Type: application/json
若返回 404，大概率是 URL 少了末尾 /；若返回 HTML 页面或乱码，说明镜像源已下线（如 https://packagist.phpcomposer.com 已停用）
阿里云内网用户请改用 http://mirrors.cloud.aliyuncs.com/composer/（注意是 http，不是 https），公网地址在内网反而更慢
某些 Docker 镜像或旧系统 OpenSSL 版本过低（curl_version() 中 version_number export COMPOSER_DISABLE_TLS=1

PHP CLI 环境缺失关键函数，Composer 启动就崩溃

宝塔、Docker 或某些定制 PHP 环境默认禁用 putenv、proc_open、pcntl_signal，Composer 连解析镜像配置的阶段都进不去。

宝塔用户：进「PHP 管理」→ 选版本 → 「禁用函数」页签 → 删除这三个函数
确认 CLI 使用的是正确 PHP：执行 which php，若指向 /usr/bin/php 而非宝塔路径，需加软链接，例如 ln -sf /www/server/php/80/bin/php /usr/local/bin/php
验证模块加载：php -m | grep -E "openssl|tokenizer"，缺任一模块都可能让 Composer 卡死
别急着配镜像——先让 composer --version 跑通，否则所有换源操作只是给一个瘫痪环境加速报错