Composer下载中断主因是元数据缓存未刷新与TLS复用失败；需验证镜像配置是否生效、手动清理repo缓存目录、并用composer update --refresh强制重拉packages.json等元数据。
直接换镜像源不能解决同步中断——它只改了请求目标，没动 Composer 的元数据缓存策略和并发行为。真正卡住你的，是 packages.json 本地缓存过期后仍被复用，加上并发下载触发 TLS 复用失败，导致中途 reset 或 timeout。
确认当前镜像是否真被调用
很多人执行了 composer config -g repo.packagist 就以为万事大吉，但实际日志里仍是 Downloading https://packagist.org/packages.json。原因有三：
- 项目级
composer.json中存在"repositories"字段（哪怕只是空数组[]），会完全屏蔽全局配置 - 键名写错：
repos.packagist（复数）才是 Composer ≥ 2.2 的正确键，repo.packagist在新版中静默忽略 - URL 缺少末尾斜杠：
https://mirrors.aliyun.com/composer❌ 返回 404；https://mirrors.aliyun.com/composer/✅ 才有效
验证方式：运行 composer install -vvv | head -n 5，第一行 URL 必须是镜像域名；再执行 composer config -g repo.packagist，输出必须是完整 JSON 对象或带斜杠的 HTTPS URL。
清理元数据缓存，不是 clear-cache
composer clear-cache 只删 ZIP 包和部分文件缓存，对决定“有没有这个包”的 packages.json 和 provider-*.json 几乎无效。这些文件藏在 ~/.composer/cache/repo/https---mirrors-aliyun-com-composer/ 这类路径下（URL 中的 / 被转义为 ---）。
- 先查路径：
composer config --global cache-dir - 再进
repo/子目录，找对应镜像的转义目录：ls -d $(composer config --global cache-dir)/repo/https---* - 手动删掉整个目录：
rm -rf $(composer config --global cache-dir)/repo/https---mirrors-aliyun-com-composer - Windows 用户路径类似：
%APPDATA%\Composer\cache\repo\https---mirrors-aliyun-com-composer
删完立刻跑 composer show monolog/monolog，Composer 才会重新拉取最新元数据。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
强制刷新元数据，跳过本地缓存逻辑
Composer ≥ 2.5 提供了精准解法：composer update --refresh。它不重下 ZIP 包，只丢弃所有缓存的元数据文件（packages.json、provider-*.json），并从当前生效镜像源强制重拉。
- 执行前务必确认：
composer config -g repo.packagist输出是你期望的镜像地址 - 若项目有
repositories字段，需临时去掉或显式加回 packagist 镜像条目 - 加
--no-cache -v可看到终端输出的真实请求 URL，确认是否命中镜像 - 老版本（--refresh 不存在
这比反复 clear-cache 或删 vendor 高效得多，也避免误删已验证可用的 dist 包。
调低并发与协议强度防中间设备截断
Connection reset by peer 不是镜像挂了，而是企业防火墙、校园网网关在 TLS 握手或 HTTP/2 协商阶段主动 RST。Composer 默认启用并行下载和 HTTP/2，加剧了这类问题。
- 关并行：
composer config -g http-max-concurrent-downloads 1（注意不是parallel-downloads，该参数已弃用） - 降级 HTTP：
composer config -g http.http_version 1.1（需 Composer ≥ 2.5） - 指定 TLS 版本（写入
~/.composer/config.json）："options": { "ssl": { "crypto_method": 3072 } }（3072 = TLSv1_2_METHOD） - CI 环境建议统一用环境变量：
COMPOSER_REPO_PACKAGIST=composer=https://mirrors.aliyun.com/composer/
这些调整不改变镜像地址，但让每次请求更“老实”，避开中间设备的兼容性雷区。
最易被忽略的是：元数据缓存路径和镜像 URL 强绑定，删错目录等于白干；而 composer diagnose 默认测的是 packagist.org，根本不管你的镜像是否通——别被它骗。
