Composer install 失败主因是镜像配置错误：键名必须为 repo.packagist、type 必须显式设为 composer、URL 需 HTTPS 且末尾带 /；项目级配置优先于全局，全局配置在有项目 repositories 字段时完全失效；还需检查 CA 证书、清缓存、验证日志路径。
Composer install 失败，八成不是网络差、不是 PHP 坏，而是镜像根本没配对——漏一个斜杠、少个 composer 类型参数、键名写成 repos.packagist，它就安静退回 https://packagist.org，不报错也不提示。
为什么 composer config -g repo.packagist 看起来成功却没生效
这条命令静默失败的三个硬条件必须同时满足：
-
repo.packagist是唯一合法键名（不能是repos.packagist、repositories.packagist或packagist.org） - 中间必须显式传入
composer作为type值：漏掉它，Composer 2.x 直接忽略该配置 - URL 必须是 HTTPS 且末尾带
/：https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（拼路径时变成/composerpackages.json，404）
验证是否真写进去了：运行 composer config -g repo.packagist。输出必须是完整 JSON 对象，例如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null、或仍返回 https://packagist.org，说明没写对。
项目级配置比全局更可靠，尤其在宝塔/CI/Docker 中
全局配置写在 ~/.composer/config.json，但只要项目根目录 composer.json 里存在 "repositories" 字段（哪怕只是 "repositories": []），全局设置就完全被跳过——不是优先级低，是彻底失效。
更关键的是权限问题：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 宝塔默认用
www用户执行命令，你在终端用root配的全局配置，www根本读不到 - CI runner（如 GitHub Actions）或 Docker 容器里可能根本没有
~/.composer目录
推荐做法：进项目根目录，运行 composer config repo.packagist composer https://mirrors.aliyun.com/composer/（注意不加 -g）。它会自动合并到 composer.json 的 repositories 字段中，key 固定为 "packagist"。如果原 composer.json 是 "repositories": []，需先手动改为 "repositories": {} 再执行，否则报错。
换源后仍卡在 “Loading composer repositories” 或报 SSL 错误
镜像只加速元数据和 ZIP 包拉取，不解决证书链或缓存污染问题。
常见真实原因：
- PHP 的
openssl.cafile和curl.cainfo指向了过期的 CA 证书文件（比如停更于 2021 年的curl-ca-bundle.crt）；修复方式是下载最新cacert.pem（从https://curl.se/ca/cacert.pem），并在php.ini中统一设置两行绝对路径：openssl.cafile="/path/to/cacert.pem"和curl.cainfo="/path/to/cacert.pem" - 没清缓存：
composer clear-cache必须执行，否则旧缓存里的packages.json还指向官方源，install仍会尝试访问packagist.org -
composer.lock和vendor/没删干净：lock 文件里的 dist URL 和 hash 来自旧源，和镜像元数据不匹配会导致校验失败或中断
最终验证必须看日志：运行 composer install -vvv，滚动到底部找类似 Reading packages.json from cache at .../https---mirrors-aliyun-com-composer/ 这样的路径，才是真走镜像。
最容易被忽略的一点：镜像地址本身要可用。截至 2026 年 7 月，实测稳定可用的只有三个——阿里云 https://mirrors.aliyun.com/composer/、腾讯云 https://mirrors.cloud.tencent.com/composer/、华为云 https://mirrors.huaweicloud.com/repository/php/。任何 http:// 开头或已下线的旧地址（如 packagist.phpcomposer.com）都会直接失败。
