换镜像本身不会引起阻塞，真正导致composer update阻塞的是镜像未生效、元数据缓存过期或项目级配置覆盖全局设置；需验证实际请求地址、用--refresh强制刷新元数据、并手动清理失效的repositories字段。
换镜像本身不会引起阻塞，真正导致 composer update 阻塞的是镜像未生效、元数据缓存过期、或项目级配置覆盖全局设置——这些问题叠加后，Composer 会反复尝试失败请求，看起来就像“卡死”。
为什么换中文镜像后反而更卡？
常见错误现象：执行 composer update 后长时间停在 Loading composer repositories with package information，或反复打印 Reading /packages.json from cache 却无后续；-vvv 日志里仍出现 packagist.org 地址。
- 镜像配置写错键名：
repos.packagist（多一个s）或repositories.packagist（新版键名但旧版 Composer 不识别）都会静默失效 - URL 缺少结尾
/：例如https://mirrors.aliyun.com/composer会被拼成/composerpackages.json→ 404 → 降级回官方源 - 项目级
composer.json中存在"repositories"字段，且值为已下线镜像（如https://packagist.phpcomposer.com），它会完全屏蔽全局配置 - 镜像站自身元数据未同步：阿里云、腾讯云等镜像通常有 1–5 分钟延迟，但若
curl -I https://mirrors.aliyun.com/composer/packages.json返回 404 或 502，则该镜像当前不可用
验证镜像是否真正在用
别信 composer config -g repo.packagist 输出正常就万事大吉——它只说明配置写进去了，不说明 Composer 正在用。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 运行
composer config --list | grep repositories.packagist.url，确认输出的 URL 和你设的一致，且没被项目级配置覆盖 - 运行
composer diagnose，看 “Repo packagist.org” 行是否显示为你的镜像地址（如https://mirrors.aliyun.com/composer/） - 最关键的验证：执行
composer update -vvv，盯住第一行日志 —— 必须是Downloading https://mirrors.aliyun.com/composer/packages.json，否则就是没走镜像
强制刷新元数据，不是清缓存
composer clear-cache 对解决“卡在 update”基本无效：它删 ZIP 和 provider 文件，但 packages.json 元数据缓存默认 15 分钟不过期，且重建时仍按旧内容算依赖，根本不会触发远程拉取。
- Composer ≥ 2.5：直接用
composer update --refresh，它只丢弃所有packages.json和provider-*.json缓存，然后从当前镜像源重载最新元数据 - Composer < 2.5：手动删元数据缓存目录：
rm -rf $(composer config --global cache-dir)/repo/https---mirrors-aliyun-com-composer（注意 URL 转义） - 删完立刻跑
composer update -vvv，观察是否开始下载新packages.json；如果还读 cache，说明路径没对或镜像 URL 本身 404
绕过 SAT 求解器卡死（非网络问题）
当 -vvv 日志明确停在 Resolving dependencies through SAT，说明瓶颈不在网络，而在版本约束太宽或存在隐式冲突。此时换镜像、调超时、清缓存全无效。
- 临时跳过深度校验：
composer update --with-all-dependencies，适用于 CI 构建或想快速生成 lock 文件 - 缩小搜索空间：把模糊约束如
"monolog/monolog": "^2.0 || ^3.0"改成具体版本"monolog/monolog": "3.5.0" - 注释掉
require-dev区块再试 —— 开发依赖常含 dev-main、git 分支等，极易触发 SAT 回溯爆炸 - 禁用插件干扰：
composer update --no-plugins --no-scripts，排除自定义插件在解析阶段注入逻辑
最易被忽略的是：项目根目录的 composer.json 里藏着一个已失效的 "repositories"，它让所有全局镜像配置形同虚设；而 composer update --refresh 只刷新元数据，不修复这个配置冲突——必须人工检查并清理。
