content-length mismatch 是 curl 下载中断导致校验失败，非 composer 崩溃；应优先 clear-cache 清除损坏缓存，再换阿里云镜像（https://mirrors.aliyun.com/composer）并重试，而非盲目调大缓存或手动下载。
Content-Length mismatch 不是 Composer 崩溃，而是它用 cURL 下载时发现服务器说“这个包有 4932506 字节”，结果只传了 179968 字节就断了——校验失败，直接报错退出。重试、换源、清缓存这三步组合拳，95% 场景能搞定。
为什么 clear-cache 比 --retry 更优先？
Composer 缓存损坏是隐形元凶：一旦 ~/.composer/cache/files/ 里存了一个只写了一半的 laravel/framework zip，下次 install 就会复用它并校验长度，必然触发 mismatch。重试再多次也没用，因为根本没重新下载。
- 先运行
composer clear-cache，确认缓存目录为空 - 再执行
composer install --retry=3，避免瞬时网络抖动导致新下载又中断 - 如果仍失败，加
--no-cache强制跳过所有本地缓存，直连下载
换源必须指定镜像地址，不能只改 config 名称
很多用户执行 composer config -g repo.packagist composer 后没填真实 URL，结果还是走默认 https://packagist.org，等于白配。国内推荐用阿里云镜像，但注意路径末尾不带 /，否则部分版本会拼出错误 URL。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（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.aliyun.com/composer - 仅当前项目换源（更安全）：
composer config repo.packagist composer https://mirrors.aliyun.com/composer - 验证是否生效：
composer config -l | grep packagist，输出应含完整镜像地址
cache-files-maxsize 调大不是万能解
把 cache-files-maxsize 改成 1024MiB 对 Content-Length mismatch 几乎无效——这不是缓存空间不够，而是文件内容损坏或传输截断。该配置只影响 Composer 是否自动清理旧缓存，不干预下载过程本身。
- 查看当前值：
composer config -l | grep cache-files-maxsize - 除非你频繁更新超大 monorepo 且磁盘空间吃紧，否则无需调整
- 真要调，也建议保持默认
300MiB，避免缓存堆积拖慢后续操作
手动下载补救只在 CI 或反复失败时用
Composer 不支持 HTTP Range 断点续传，所以卡在同一个大包（比如 symfony/symfony 的 12MB zip）超过三次，就可以手动干预。
- 从
composer.lock找对应包的dist.url字段 - 用
wget -c <url></url>或curl -C - <url></url>下载到临时路径 - 计算文件 hash：
sha256sum <file></file>，和 lock 文件中dist.shasum对比 - 确认一致后，按
vendor/name/sha256hash/<file>.zip</file>结构放进缓存目录
这步容易因目录结构或 hash 错位导致二次失败，日常开发别硬刚，优先确保网络干净、镜像可用、缓存清空。
