解决Composer中文镜像引起 Composer update 进程阻塞现象-composer-PHP中文网

换镜像本身不会引起阻塞，真正导致composer update阻塞的是镜像未生效、元数据缓存过期或项目级配置覆盖全局设置；需验证实际请求地址、用--refresh强制刷新元数据、并手动清理失效的repositories字段。

解决composer中文镜像引起 composer update 进程阻塞现象

换镜像本身不会引起阻塞，真正导致 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 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 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 只刷新元数据，不修复这个配置冲突——必须人工检查并清理。