Composer下载失败怎么解决（网络诊断）-composer-PHP中文网

“http connectivity to packagist: fail”基本就是dns劫持的铁证，因内网防火墙或教育网常将packagist.org解析为127.0.0.1或空响应，导致http探活失败；而https因sni机制可能绕过污染，故浏览器能打开不代表诊断无问题。

composer下载失败怎么解决（网络诊断）

composer diagnose 报 “http connectivity to packagist: FAIL” 怎么看

这基本就是 DNS 劫持的铁证，不是网络慢，也不是你没连 Wi-Fi。Composer 的 diagnose 命令会先走 HTTP（非 HTTPS）探活，而很多内网防火墙或教育网 DNS 会把 packagist.org 解析成 127.0.0.1 或空响应，导致 cURL 直接报 Connection refused。

浏览器能打开 https://packagist.org 不代表没问题——HTTPS 走 TLS 握手 + SNI，绕过了部分 DNS 污染，但 diagnose 的 HTTP 检查更早、更裸，反而更准。

别急着改代理或重装 PHP，先验证 DNS：

dig packagist.org +short —— 如果返回 127.0.0.1、0.0.0.0 或明显非官方 IP（比如 114.114.114.114 返回的私有段），就是 DNS 劫持
curl -Iv http://packagist.org —— 卡在 Resolving 阶段或直接报错，而 curl -Iv https://packagist.org 成功，也佐证是 DNS 层问题

镜像源配错导致 diagnose 显示 OK 但 install 失败

全局配置写成 repos.packagist（多一个 s）或漏掉 {"type": "composer", "url": ".../"} 结构，diagnose 会显示 Repo packagist.org: OK，但实际请求仍走原始源。

真正生效的写法只有两种（任选其一）：

Composer 2.2+ 推荐：composer config -g repositories.packagist.org '{"type": "composer", "url": "https://mirrors.tuna.tsinghua.edu.cn/composer/"}'（注意末尾必须带 /）
兼容旧版写法：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

验证是否真生效：

运行 composer diagnose，找 Repo packagist.org: 这一行，后面域名必须是你配的镜像地址（如 mirrors.tuna.tsinghua.edu.cn）
执行 composer require monolog/monolog -vvv，日志第一行 Downloading https://... 的域名要匹配镜像
如果仍走 packagist.org，立刻检查项目级配置：composer config repo.packagist，它优先级高于全局，会完全屏蔽你的 -g 设置

“Connection reset by peer” 或 “cURL error 56” 是镜像不稳定信号

这不是本地 SSL 或 PHP 错误，而是中间链路（防火墙、NAT 网关、过期证书的镜像站）主动断开了 TCP 连接。常见于某些已停服或证书过期的镜像（比如旧版阿里云镜像）。

别用浏览器访问镜像 URL 测试——Composer 发请求带特定 User-Agent 和 SNI，和浏览器行为不一致。

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 https://mirrors.tuna.tsinghua.edu.cn/composer/
仅当前项目：composer config repo.packagist composer https://mirrors.tuna.tsinghua.edu.cn/composer/（去掉 -g）
若清华源也不行，试华为云：composer config -g repo.packagist composer https://repo.huaweicloud.com/repository/php/

切忌手动编辑 ~/.composer/config.json——JSON 格式稍错就失效，composer config 命令会自动校验并格式化。

超时与重试参数不生效？检查环境变量和版本

很多人设了 --timeout=300 还失败，是因为混淆了两个关键阈值：

COMPOSER_NETWORK_TIMEOUT：控制单次 HTTP 请求超时（单位秒），适合解决首字节延迟；设为 300 或 600
COMPOSER_PROCESS_TIMEOUT：控制整个命令最长运行时间（含解压、脚本执行），设太小会导致大包被直接 kill；建议至少 1800

重试次数需 Composer 2.2+ 才支持：--retries=5。低于此版本无效。

组合使用最稳：COMPOSER_NETWORK_TIMEOUT=600 COMPOSER_PROCESS_TIMEOUT=1800 composer install --retries=5

注意：这些参数对已缓存失败的下载无效。若 install 卡在 downloading，先清缓存：composer clear-cache，再加 --no-cache 强制跳过损坏缓存重试。

镜像源只是元数据代理，ZIP 包下载仍可能直连原始源——这点最容易被忽略。即使 packages.json 走了镜像，具体包的 .zip 地址仍可能指向 github-releases.githubusercontent.com，国内访问极不稳定。遇到这种情况，要么换全链路镜像（如华为云），要么单独为 GitHub 依赖配 github-protocols https: 并确保 token 可用。