composer镜像未生效的首要原因是键名错误，必须使用repo.packagist.org（含.org后缀），旧写法无效；输出应为含合法url（末尾带斜杠）的json结构，否则说明仍走官方源。
composer config -g repo.packagist 输出为空或不是完整 URL？说明镜像根本没生效
这是最常见也最容易被忽略的起点。Composer 2.2+ 只认 repo.packagist.org 这个键名（注意是 .org 后缀），repo.packagist 或 repos.packagist 都是旧写法，可能残留但不参与路由。
- 执行
composer config -g repo.packagist.org—— 必须带.org，输出应为类似{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}的完整结构，且url值末尾必须有斜杠 - 如果输出为空、是
https://packagist.org或报错Could not find repository 'packagist.org'，说明当前走的是官方源 -
composer config -l | grep repo可快速筛出所有相关项，重点看repo.packagist.org是否存在且值合法 - Windows 下 Git Bash 可能写入路径错误，用
composer config -g -l确认真实生效位置，别只信自己执行过的命令
curl 测镜像返回 200，但 composer install 还是卡住？问题不在连通性，在真实接口和缓存
镜像首页返回 HTTP 200 并不代表 Composer 能用——它真正依赖的是 /p2/ 和 /packages.json 接口返回的有效 JSON 结构，且必须含 "packages" 字段。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 别只测根路径：
curl -fsSL https://mirrors.aliyun.com/composer/p2/monolog/monolog.json | jq -e 'has("packages")' >/dev/null才算通过基础验证 - 阿里云已迁至
https://mirrors.aliyun.com/php-composer/，旧路径/composer/在 2025 年底起逐步失效，404 就是这个原因 - 腾讯云自 2026 年 3 月起要求 User-Agent 头，否则 403，需加
-A "Composer/2.9" -
composer clear-cache必须在换源后立即执行——否则旧缓存里的packages.json仍指向境外地址，请求 URL 看起来对，实际内容早已过期
项目里写了 "repositories": []，全局镜像就自动失效？没错，这是设计行为
只要项目根目录的 composer.json 中存在 "repositories" 字段（哪怕空数组），Composer 就会彻底忽略全局配置，完全按项目级定义走。
- 执行
composer config repositories（在项目目录下）—— 输出内容就是此刻真实生效的源列表，别猜 - 若需同时使用私有源 + 公共镜像，必须把阿里云源显式写进
repositories数组，并在同一数组中设置"packagist.org": false - 不要混用
type: "composer"和type: "vcs"：前者才是镜像源标准类型；后者只是 Git 地址，不能替代索引加速 - 某些 CI/CD 环境会注入环境变量覆盖配置，检查是否设置了
COMPOSER_REPO_PACKAGIST
镜像源突然变慢或间歇性失败？先测延迟，再切备用源
慢 ≠ 没生效，大概率是本地到镜像节点链路不稳定，DNS 或 HTTPS 握手耗时高。阿里云 CDN 在部分地区异常时，腾讯云或 USTC 镜像反而更稳。
- 用
time curl -o /dev/null -s -w "time: %{time_total}s\n" https://mirrors.aliyun.com/composer/packages.json实测真实响应时间，重点关注real时间是否稳定 ≤1.5s - 华南用户可优先试腾讯云：
https://mirrors.cloud.tencent.com/composer/；教育网或城域网用户可试华为云：https://repo.huaweicloud.com/composer/（注意它不托管 dist 包） - 已停用镜像必须避开：
https://packagist.phpcomposer.com和https://packagist.laravel-china.org自 2023 年起不再维护，现在用必失败 - 健康检查脚本务必设
--max-time 3，超时即 failover，别让一次卡顿拖垮整个构建流程
