composer更新失败主因是镜像配置错误或失效，需确认版本≥2.5、镜像url正确（含结尾斜杠）、未被项目级repositories覆盖，并用composer diagnose验证实际请求域名。
Composer 本身没有镜像源同步的异常捕获与重试机制——它不负责同步，只负责请求；所谓“同步异常”，其实是你本地配置、缓存或网络链路出了问题。
composer update --refresh 不是重试，是强制丢弃元数据缓存
很多人以为加 --refresh 是让 Composer “多试几次”，其实它干的是另一件事：删掉本地缓存的 packages.json 和所有 provider-*.json，然后从当前生效的镜像源重新拉一遍索引。它不重试 HTTP 请求，也不换源，更不修复配置错误。
- 必须 Composer ≥ 2.5 才支持，低版本加了也静默忽略
- 只刷新元数据，已下载的 ZIP 包（
~/.composer/cache/files/）保留不动 - 如果
composer config -g repo.packagist返回空或仍是https://packagist.org，那--refresh依然连官方源 - 项目根目录
composer.json里有"repositories"字段，会直接屏蔽全局镜像，--refresh无效
curl -I 是唯一可信的镜像可用性验证方式
别信 composer diagnose 的输出——它默认只测 https://packagist.org，完全不走你配的镜像。真正要看镜像是否活、是否同步到位，得自己发请求：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 运行
curl -I https://mirrors.aliyun.com/composer/packages.json，必须返回HTTP/2 200，且Last-Modified时间接近当前时间 - 查具体包：
curl -I https://mirrors.aliyun.com/composer/p/laravel/framework.json，404 表示该镜像还没同步到这个包的 provider 文件 - 对比官方源：
curl -s https://packagist.org/packages.json | jq -r '.lastModified'vs 镜像源同命令结果，差超过 10 分钟就说明滞后 - Windows 用户注意路径转义：镜像 URL 中的
/在缓存路径里变成---，如https---mirrors-aliyun-com-composer
重试参数 --retries 和 http.timeout 解决的不是同一类问题
--retries=5 和 http.timeout=600 经常被混用，但它们作用完全不同：
-
--retries控制单个 HTTP 请求失败后的重试次数（比如 DNS 失败、CURL 错误 6/28），默认 3 次，对 404、SSL 错误、域名解析失败无效 -
http.timeout是单次请求最大等待时间（单位秒），不是整个命令超时；默认 60 秒，在高延迟或 NAT 超时链路上根本不够，卡在Downloading (0%)就是它不够 - 设置方式：临时用
COMPOSER_HTTP_TIMEOUT=600 composer install，永久用composer config -g http.timeout 600（注意不是http-timeout） - 调大
--retries对镜像 URL 写错、证书过期、域名已注销等问题毫无帮助——它只会反复请求一个根本不存在的地址
手动清理缓存目录比 composer clear-cache 有效十倍
composer clear-cache 只清 files/ 和部分内存缓存，对真正卡住你的元数据缓存（repo/ 下的 JSON）几乎没影响。这些文件一旦损坏或过期，Composer 就读缓存、不发请求，--refresh 也救不了。
- 先确认路径：
composer config --global cache-dir，再进repo/子目录找对应镜像的转义名，如https---mirrors-aliyun-com-composer - Linux/macOS：运行
rm -rf $(composer config --global cache-dir)/repo/https---mirrors-aliyun-com-composer - Windows：删
%APPDATA%\Composer\cache\repo\https---mirrors-aliyun-com-composer - CI 构建中建议固定加这一步：
composer clear-cache && rm -rf $(composer config --global cache-dir)/repo/ - 删完立刻跑
composer show vendor/package，Composer 才会真实发起新请求
最常被忽略的一点：镜像 URL 末尾的 / 是硬性要求，少写就 404；而 repositories 字段的存在，会让所有全局配置失效——这两处出错，任何重试、刷新、调参都白搭。
