composer下载卡在416错误是因cdn缓存了不完整文件并错误透传accept-ranges头，而源站实际不支持range分段下载；验证可用curl -i -h "range: bytes=0-1023"测试，返回416即为伪支持；解决方法包括清缓存、禁用重试、切换至清华源等。
Composer下载卡在Range头被CDN拒绝？先确认是否真触发了Range请求
Composer默认不会主动发Range请求，只有在断点续传或重试时才可能带上。如果你看到cURL error 56: SSL read: errno=0或Content-Length mismatch后重试失败，再出现416 Requested Range Not Satisfiable，那基本是CDN节点缓存了不完整响应，又错误地把Accept-Ranges: bytes头透传给了Composer——而镜像源本身并不支持Range分段下载。
验证方式很简单：curl -I -H "Range: bytes=0-1023" https://mirrors.aliyun.com/composer/dists/monolog/monolog/2.9.0.0/monolog-monolog-2.9.0.0-zip-5a8b7d.zip。如果返回416，说明CDN在“假装支持Range”，实际后端没启用；如果返回200或206，才是真支持。
阿里云/腾讯云镜像为何会返回416？CDN配置与源站同步的错位
阿里云华北节点（https://mirrors.aliyun.com/composer-cn-beijing/）和腾讯云（https://mirrors.cloud.tencent.com/composer/）均使用CDN加速，但它们的源站是定时同步Packagist dist ZIP包，不是实时写入。当CDN边缘节点缓存了某个ZIP的Content-Length头（比如1234567），但源站该文件还没同步完、或同步中断导致实际大小只有1234500字节，此时若Composer重试并带Range: bytes=1234500-，CDN就会返回416——它只认自己缓存的长度，不管源站真实状态。
- 这不是你本地配置问题，也无需改
composer.json - 不要手动加
curl -H "Range:"去测试，Composer底层控制逻辑复杂，自行模拟容易误判 - 清华源（
https://mirrors.tuna.tsinghua.edu.cn/composer/）较少出现此问题，因其CDN策略更保守，不透传Accept-Ranges头
绕过Range异常的三个实操动作
核心思路：不让Composer发Range，也不让CDN有机会返回416。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 强制清空缓存并禁用断点续传：
composer clear-cache，再执行composer install --no-cache - 关闭HTTP复用与范围请求：
composer config -g http.ssl.certificate_authority /etc/ssl/certs/ca-certificates.crt（确保证书链正常），然后composer config -g http.no-body false（避免误判）、composer config -g http.max-retries 0（禁用自动重试，防止二次Range） - 换源比调参更快：
composer config -g repo.packagist composer https://mirrors.tuna.tsinghua.edu.cn/composer/，清华源CDN不返回Accept-Ranges，彻底规避该路径
为什么--retry=3有时反而加重416错误？
Composer的--retry参数只控制HTTP请求重试次数，不改变请求头逻辑。一旦首次下载因网络抖动中断，它会在下次请求中自动补上Range头继续下载——而CDN缓存的元数据早已失效，结果就是连续三次416，最后报Failed to download。
真正有效的重试，是清缓存+换源+单次完整下载。如果你正在CI中跑composer install --retry=3并频繁遇到416，立刻删掉--retry，改用composer install --no-cache配合清华源。
CDN对Range的支持是“全有或全无”，没有中间态。别指望调一个参数就让它变聪明——要么换不透传Range的镜像，要么接受它偶尔抽风。
