换镜像不能解决 Composer 依赖冲突，它只让报错更快、更准；真正卡住你的，永远是 composer.json 里互相打架的 require、conflict 和宽松的 PHP 平台声明。
换镜像不能解决 Composer 依赖冲突，它只让报错更快、更准；真正卡住你的，永远是 composer.json 里互相打架的 require、conflict 和宽松的 PHP 平台声明。
为什么换镜像后报错变快，但问题还在？
阿里云、腾讯云等镜像只加速元数据（packages.json、provider-*.json）下载，不改变 SAT 求解逻辑。你看到“Resolving dependencies through SAT”卡住 2 分钟 → 换镜像后 15 秒就报 Conclusion: Your requirements could not be resolved，不是问题修好了，而是求解器更快穷尽了所有无解路径。
常见误判：
- 把
conflict字段或platform版本不匹配当成网络问题去换源 - 看到“Package not found”就切镜像：其实是包名拼错或版本根本不存在
- CI 中换镜像后构建失败：说明本地开发用的是过期缓存，镜像已同步真实约束，暴露了长期被忽略的冲突
用 composer why-not 定位真实拦路虎
这是唯一能快速定位冲突源头的命令，但必须配合清缓存和正确镜像才准：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 先执行
composer clear-cache：防止旧元数据误导判断 - 确认镜像配置有效：
composer config -g repo.packagist输出必须含"url": "https://mirrors.aliyun.com/composer/"（注意末尾斜杠） - 运行
composer why-not vendor/package:version，例如composer why-not laravel/framework:11.0 - 如果输出为空，不是镜像问题，是你没在
composer.json里声明该包，或版本号写成11而非11.0
输出是反向链，要从最后一行（通常是你的根项目）倒着读——最后一行才是你 composer.json 的声明，往上每行末尾的 (required by ...) 是阻断源头。
composer update 怎么定点升级，不引发新冲突？
全量 composer update 会让 SAT 求解器反复试错，尤其项目有 30+ 包时极易卡死。真要升级某个包，必须精准控制范围：
- 显式写出包名，不带引号、不带
^或~：例如composer update monolog/monolog --with-dependencies -
--with-dependencies是关键：它允许升monolog/monolog所需的最小依赖集（比如psr/log），但不会动phpunit/phpunit这类无关项 - 升级后立刻
git diff composer.lock：确认只有目标包及其直系依赖被改，多改一个symfony/polyfill-*都可能埋隐患 - 降级跨主版本（如
guzzlehttp/guzzle从^8.0切回7.4.5）时，必须写死版本："guzzlehttp/guzzle": "7.4.5"，而非"^7.0"——避免 Composer 自行选到不兼容的小版本
哪些硬伤换十次镜像都无效？
以下三类问题发生在约束逻辑层，镜像再快也绕不过：
-
"php": ">=7.4"这类太宽泛的平台声明：会让求解器遍历几百个历史版本；收紧为"php": "^8.1"可减少 80%+ 组合空间 - 混用
dev-main和稳定版：某个私有包刚推了dev-main，其composer.json里悄悄加了"require": {"monolog/monolog": "^3.0"}，而主项目锁的是^2.0→ 冲突立刻触发 -
conflict字段显式拦截：例如"spatie/laravel-backup": "7.0.0"自带"conflict": {"laravel/framework": ">=11.0"}，哪怕你没装 L11，只要某依赖间接拉入 L11，求解器就会失败
这些不是配置错误，是约束本身无交集。你得去 Packagist 查哪个中间版本被上下游同时接受，然后手动锁死——而不是指望镜像替你“智能绕过”。
