content-length mismatch 错误本质是网络丢包、中断或缓存污染导致接收字节数与响应头声明不符；换阿里云等可靠镜像源并清缓存可解决90%问题，因阿里云镜像同步快、https稳定、节点近，大幅降低丢包概率。
Content-Length mismatch 错误不是 Composer 的 bug，是网络传过来的字节数和服务器声明的 Content-Length 头对不上——本质是丢包、中断或缓存污染。换镜像源 + 清缓存，能解决 90% 的情况。
为什么阿里云镜像能绕过丢包问题
packagist.org 官方源在国内直连极不稳定：CDN 缓存不同步、TLS 握手失败、中间代理截断都可能导致 ZIP 包传输被截断。阿里云镜像同步延迟低、HTTPS 可靠、节点离用户近，大幅降低丢包概率。
- 全局设置（推荐）：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/（注意末尾斜杠不能省） - 仅当前项目设置：
composer config repo.packagist composer https://mirrors.tencent.com/composer/ - 验证是否生效：
composer config -l | grep repo.packagist，输出应含镜像 URL -
https://packagist.phpcomposer.com已停用，强行使用会返回空响应，触发同样错误
清缓存比重试更重要
Composer 默认把下载的 ZIP 存在 ~/.composer/cache/files/，一旦某次下载只写入一半（比如 WiFi 断了），下次安装就会复用这个坏文件，并在校验时发现“收到 123456 字节，但头里说该有 789012 字节”。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 先清缓存：
composer clear-cache（等提示 “All caches cleared.”） - 确认缓存目录为空：
ls -la $(composer config cache-dir)/files/应无.zip文件 - 再装：
composer install --retry=3，避免瞬时波动失败 - 若仍失败，加
--no-cache强制跳过所有本地缓存：composer install --no-cache --retry=3
别迷信 --retry 参数
--retry 只是重发整个请求，对已损坏的缓存文件毫无作用。它不能修复丢包残留的半截 ZIP，也不能绕过被污染的元数据缓存。
- 元数据缓存（如
packages.json）不随clear-cache清除，需手动删：rm -rf $(composer config cache-dir)/repo/https---mirrors.aliyun.com-composer - 若报
SSL certificate problem: unable to get local issuer certificate，说明 PHP 的curl.cainfo没设对，不是镜像问题 - 企业内网若走 HTTPS 解密代理（如 Zscaler），需导出企业根证书并配置：
composer config -g cafile /path/to/company-ca.crt
