针对Composer镜像源的Metadata压缩包在网络传输中的丢包重传-composer-PHP中文网

答案：composer metadata下载卡在0%或反复失败本质是网络链路中断，非丢包重传问题；应优先切换https镜像源并清理对应缓存目录，而非调重试参数或删错缓存。

针对composer镜像源的metadata压缩包在网络传输中的丢包重传

Composer metadata下载卡在0%或反复失败，不是丢包重传问题

Composer本身不实现TCP层的丢包重传，它依赖底层cURL——而cURL默认不启用自动重传机制。所谓“Metadata压缩包传输中断”，实际是连接被中间设备（如运营商NAT、企业防火墙）静默切断后，cURL未收到完整响应就报错，后续重试又撞上同样断连路径，形成死循环。

常见现象包括：cURL error 28: Operation timed out、failed to open stream: Connection refused、进度条长期停在Downloading https://.../provider-2024-07.json等URL上不动。运行composer install -vvv末尾反复出现这类错误，基本可锁定为网络链路问题，而非metadata包本身损坏。

PHP的default_socket_timeout对Composer无效，它走的是自己的cURL配置
composer install --no-cache能绕过本地缓存，但无法修复底层连接中断
别指望Composer自动降级协议或切换备用源——除非你显式配置多个repositories

metadata元数据根本不是“压缩包”，而是JSON索引文件

所谓“Metadata压缩包”是个常见误解。Composer拉取的packages.json、provider-*.json都是纯文本JSON文件，没有gzip压缩传输（镜像站返回头里Content-Encoding: gzip极少出现），更不存在ZIP格式的metadata包。它们体积小（通常几十KB）、结构扁平，出问题几乎全是网络层阻断，而非文件解压失败。

真正下载ZIP的是包本体（dist包），路径类似https://mirrors.aliyun.com/composer/dists/vendor/package-name/1.2.3.zip；而metadata路径是https://mirrors.aliyun.com/composer/p2/vendor/package-name.json或根目录下的packages.json。

Discussion Composer

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

下载

metadata决定“有哪些版本可用”，它不校验checksum，也不需要解压
一旦packages.json缓存过期（默认15分钟）或被--refresh强制丢弃，Composer会重新GET这个JSON文件
如果该URL返回404或空内容，说明镜像站还没同步完，不是你本地丢了包

换镜像源比调重试参数更有效

Composer的--retries=5只对单次HTTP请求生效，解决不了持续性链路中断。国内用户直连packagist.org失败率高，主因是TLS握手超时或SNI被干扰，不是丢包率高。此时换镜像源才是治本方案——阿里云、腾讯云、华为云三家HTTPS镜像已稳定运行多年，CDN节点覆盖广，且同步延迟控制在3～30分钟内。

全局配置命令必须完整：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/（注意末尾/）
验证是否生效：运行composer diagnose，看Repo packagist.org:行输出是否为https://mirrors.aliyun.com/composer/
项目级配置优先级更高，若composer.json里有"repositories"字段，全局设置会被忽略