换镜像不解决版本冲突，仅加速元数据下载并让SAT求解器更快暴露真实约束矛盾；真正卡住的是composer.json中互斥的require与conflict规则，须用composer why-not、prohibits和show --tree精准定位阻断源。
换镜像不会解决版本冲突，它只会让冲突报错更快、更准——你看到的“换镜像后能装了”，大概率是旧镜像缓存了过期元数据，新镜像拉到了真实约束，反而暴露了你一直忽略的硬冲突。
镜像只加速下载，不绕过约束检查
Composer 镜像（如 https://mirrors.aliyun.com/composer/）本质是 Packagist 的代理层，它不参与依赖解析，也不修改 composer.json 中的 require、conflict 或 platform 规则。所有冲突判断仍由本地 Composer 执行 SAT 求解器完成。
- 换镜像后
composer update从 2 分钟降到 15 秒？不是问题变简单了，是元数据加载快了，求解器更快穷尽无解路径 - 看到
Package not found就切镜像？很可能是包名拼错（laravel/sanctum写成laravel/Sanctum）、版本不存在（^3.0对应的 stable tag 实际只有2.14.0），和镜像无关 - CI 构建失败但本地 OK？说明本地
composer.lock或缓存用了旧元数据，镜像已同步最新conflict字段，把隐患提前捅破
用 composer why-not 定位真实拦路虎
镜像提速后，composer why-not vendor/package:version 响应几乎实时，这是你最该依赖的诊断组合。关键在“完整版本号”——^3.0 或 3.0 都会报 [InvalidArgumentException] Package not found，必须填实际发布的 tag，比如 laravel/sanctum:3.2.1。
- 输出末尾出现
your-project-name？说明是你自己的composer.json里写了互斥约束，比如同时 require"spatie/laravel-backup": "^4.0"和"laravel/framework": "^11.0" - 输出为空？不是没冲突，而是目标包未被显式声明，或冲突来自
require-dev（如phpunit/phpunit锁死了symfony/console版本） - 运行前务必
composer clear-cache，尤其刚切换镜像后，防止本地缓存污染判断
composer prohibits 比 why-not 更准
当你执行 composer require laravel/framework:^11.0 失败时，composer why-not laravel/framework:11.0.0 可能返回空（因为你根本没在 composer.json 里声明它），但 composer prohibits laravel/framework:11.0.0 会立刻指出： spatie/laravel-backup v7.2.0 requires symfony/console ^5.4 (for spatie/laravel-backup v7.2.0) ——括号里的内容就是你要处理的具体包和版本。
- 必须带精确版本号：
laravel/framework:11.0.0✅，laravel/framework:^11❌ - 反复出现在输出里的包（如
symfony/console、monolog/monolog）大概率是枢纽包，优先盯住它们 - 某行末尾标了
(locked to 5.4.32)？说明这个版本已被composer.lock固定，删 lock 或加--with-all-dependencies才可能松动
别忽略 composer show --tree 揭露的真实依赖链
composer show --tree 输出的是 composer.lock 里已解析的真实结构，不是你 composer.json 里写的“理想状态”。很多冲突藏在第二、三层依赖里，靠这个命令才能暴露。
- 运行
composer show --tree | grep "symfony/console"，直接看到它被谁引入、路径多深、是否带(locked to 5.4.32) - 树里出现同名包不同版本（如
symfony/console v5.4.33和v6.4.7）？说明有包用了replace或conflict声明，得去对应包的composer.json查 - 看到
(replaced)或(provided)标记？立刻查该包的composer.json，确认是否真能等价替代，别信名字
真正卡住你的永远不是镜像，而是 composer.json 里那些互相打架的 requires 和隐含的 conflict 规则——镜像越快，越容易让你忽略这点。
