Composer install 404主因是源不可达而非包丢失，应配置多源fallback：在composer.json中设"repositories"含"canonical":false的镜像和备用packagist.org，并启用"packagist":false。
Composer install 时提示 404 Not Found 怎么办
这不是包真丢了，大概率是默认源（packagist.org）访问不稳定或被拦截，导致 Composer 拿不到元数据或 ZIP 包。直接换镜像源能解决 90% 的情况，但关键是要“自动 fallback”，而不是每次手动改 composer.json 或全局配置。
为什么不能只靠 composer config -g repo.packagist 临时切源
全局设置镜像源（比如设成阿里云或腾讯的）确实能绕过 404，但它是一劳永逸的“单点切换”，一旦镜像本身同步延迟、临时不可用，或者你正在协作的项目明确要求走官方源（比如审计场景），就会卡住。真正的“自动 fallback”需要 Composer 原生支持的多源策略。
-
composer.json中的repositories是按顺序查找的，第一个命中即停，不自动试下一个 - 官方源
{"type": "packagist", "url": "https://packagist.org"}和镜像源不能共存为同一 type —— 否则会报错Repository type "packagist" is reserved for the default packagist.org repository - 必须用
packagist.org的“代理模式”：保留默认源，再加一个 type 为composer的镜像仓库，并显式禁用默认源
怎么写可 fallback 的 repositories 配置
在项目根目录的 composer.json 里，用以下结构即可实现“先试镜像，镜像挂了自动回退到官方源”：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
{
"repositories": [
{
"type": "composer",
"url": "https://mirrors.aliyun.com/composer/",
"canonical": false
},
{
"type": "packagist",
"url": "https://packagist.org"
}
],
"packagist": false
}
注意三点：
-
"canonical": false是关键 —— 它告诉 Composer 这个镜像不是权威源，允许后续继续查其他源 -
"packagist": false必须加上，否则 Composer 仍会默认启用内置的packagist.org，导致重复或冲突 - 阿里云、腾讯云、华为云镜像 URL 都可用，但不要混用多个镜像（它们同步节奏不同，可能返回不一致的包版本）
遇到 file_get_contents(): php_network_getaddresses: getaddrinfo failed 怎么关联排查
这个错误常被误判为 DNS 或网络问题，其实往往是 Composer 在尝试访问某个已失效的私有源或拼错的镜像地址。它和 404 不同，属于连接层失败，但触发场景相似（比如镜像域名过期、HTTPS 证书不对、或用了 HTTP 协议但镜像已强制跳转 HTTPS）。
- 检查镜像 URL 是否带
https://，旧文档里有些还写http://，现在基本都拒接 - 执行
curl -I https://mirrors.aliyun.com/composer/看是否返回200 OK，而不是301/302或超时 - 如果公司内网有代理，确认
HTTP_PROXY/HTTPS_PROXY环境变量没指向一个已下线的出口
真正可靠的 fallback 不是堆镜像数量，而是让 Composer 明确知道“哪个是备用、哪个是保底”，以及确保每个链路在 DNS、TLS、HTTP 状态码层面都真实可达。
