ThinkPHP依赖冲突本质是扩展包对共享依赖版本要求互斥，解决关键在于用composer why-not和prohibits定位阻断包，结合show命令验证真实依赖树，精准更新而非全量重算，并排查PHP版本、镜像配置及类库别名等环境问题。
ThinkPHP 项目中 Composer 依赖冲突，核心不是框架本身有问题，而是多个扩展包对 topthink/framework 或其他共享依赖（如 guzzlehttp/guzzle、psr/log）提出了互斥的版本要求。解决关键在于“看清谁在拦路”，而不是反复删 vendor 或硬改版本号。
先定位真正卡住的包
报错里出现 found x packages with version constraints that are not satisfiable，说明 Composer 已穷举无解。此时最有效动作是：
- 运行
composer why-not topthink/framework:6.1.5（把 6.1.5 换成你目标版本或报错中提到的版本），输出会从下往上列出阻断链，最后一行是你composer.json的根声明，倒数第二行就是第一个明确拒绝该版本的包 - 再运行
composer prohibits topthink/framework:6.1.5，它会列出所有正在拉扯这个版本的包，重点关注topthink/think-*、overtrue/*或私有扩展名 - 特别检查
require-dev区块——phpunit/phpunit、mockery/mockery常悄悄锁死sebastian/exporter，间接卡住框架升级
别信 composer.json，要看真实依赖树
composer.json 是你的“愿望清单”，composer.lock 和 vendor/ 才是当前真实状态。验证方式：
- 执行
composer show --tree | grep think，确认topthink/framework实际装的是哪个版本，以及它被哪些包引入 - 用
composer show topthink/framework查看它自身 require 了哪些包，再比对冲突包的 require 列表，找语义化版本交集（比如一个要^6.0，另一个要^6.1，交集就是6.1.x） - 如果发现某个扩展包仍 require
"topthink/framework": "^5.1"，哪怕没报错，也属于 TP5/TP6 混用隐形炸弹，运行时调用\think\Request就会炸
精准更新，避免全量重算
别一上来就 composer update，那会让 SAT 求解器在复杂项目中卡死几分钟甚至失败：
立即学习“PHP免费学习笔记（深入）”；
- 升级框架：用
composer update topthink/framework --with-dependencies，只动它和直系依赖 - 降级跨主版本（如从 6.1.x 回退到 6.0.12）：必须在
composer.json中写死"topthink/framework": "6.0.12"，再执行composer update topthink/framework - 临时验证兼容性：加
--dry-run -v参数，例如composer require topthink/think-swoole:^4.0 --dry-run -v，提前看是否能解出路径，不改任何文件
环境与配置细节不能忽略
很多“报错”其实跟依赖无关，而是环境或配置偏差：
- 确保 PHP 版本达标：TP6 要 ≥7.2.5（推荐 ≥7.4），TP8 要 ≥8.0；运行
php -v和php --ini（Windows 用户尤其注意 CLI 加载的 php.ini 是否启用mbstring、openssl等扩展） - 镜像必须切对：全局执行
composer config -g repo.packagist https://mirrors.aliyun.com/composer/，再用create-project安装，不用require - 别手动写 alias 映射：TP6.1+ 默认关闭类库别名机制，
config/app.php中的'alias' => []已无效，应改用 PSR-4 自动加载 + 容器绑定
