composer why-not 直接定位阻断包：如 topthink/think-swoole 3.0.0 requires topthink/framework ^6.0，说明该扩展只兼容 TP6；空输出时加 -v 查完整推理链，确认是否被 lock 文件钉死旧版本；同时需验证 PHP 扩展（mbstring/json/fileinfo）在 CLI 和 Web 环境均启用。
composer why-not 报什么就查什么
ThinkPHP 8 升级卡住，90% 是因为某个包在“暗中拦路”，composer why-not 就是把它揪出来的命令。它不猜、不绕弯，直接告诉你「谁不让装」以及「为什么不让」。
常见用法：
-
composer why-not topthink/framework:^8.0—— 查哪个包阻止 TP8 安装 -
composer why-not php:8.1—— 查哪个依赖还死守 PHP 7.x -
composer why-not topthink/think-orm:^3.0—— 查 ORM 3.0 被谁拖后腿
输出示例里常出现这类行：topthink/think-swoole 3.0.0 requires topthink/framework ^6.0，说明这个 Swoole 扩展只认 TP6，必须升级或换掉它。别试图硬覆盖——Composer 的依赖解析是全图推导，局部强改只会让后续更乱。
why-not 没输出？试试加 -v 参数看细节
有时 composer why-not 返回空或只说「no matching packages」，不是没冲突，而是默认模式下过滤太狠。加 -v（verbose）能展开完整推理链：
立即学习“PHP免费学习笔记（深入）”；
composer why-not topthink/framework:^8.0 -v
你会看到类似这样的路径回溯：
Root composer.json requires topthink/framework ^8.0 -> satisfiable by topthink/framework[8.0.0, ..., 8.1.0]. But topthink/think-queue 4.0.2 requires topthink/framework ^6.0 -> satisfiable by topthink/framework[6.0.0, ..., 6.3.5]. And topthink/think-queue 4.0.2 is locked to version 4.0.2 in composer.lock.
关键点：
- 最后一句
is locked to version ... in composer.lock提示你：不是配置写错了，是 lock 文件里钉死了旧版本 - 此时要先
composer update topthink/think-queue --with-dependencies，而不是直接删 lock - 如果该包已废弃（如老版
think-wechat），得手动替换成社区维护的替代品，比如overtrue/wechat
检查扩展是否启用比检查包版本更优先
很多「依赖冲突」其实是假象——composer why-not 报错说某包不兼容，但真实原因是 PHP 缺扩展，导致 Composer 自动加载失败，进而误判类不存在。TP8 强制依赖 mbstring、json、fileinfo，少一个都可能让 why-not 给出误导性结论。
验证方式（两步缺一不可）：
- CLI 环境：
php -m | grep -E 'mbstring|json|fileinfo'—— 必须有输出 - Web 环境：建
info.php写<?php phpinfo(); ?>，浏览器访问，确认三个扩展状态为enabled
特别注意：fileinfo 在部分 Docker 镜像或宝塔环境中默认关闭，错误信息不会明说，但会导致 think-orm 初始化失败，继而让 why-not 显示「找不到 think\Model」——其实 Model 类根本没机会加载。
冲突解决后一定要刷新 autoload
改完 composer.json、升级了包、甚至手动绑定了类，如果控制器里仍报 Class not found，大概率是 Composer 自动加载映射没更新。TP8 对命名空间和路径匹配极其严格，class_exists('app\service\UserService') 返回 false 就代表容器连类在哪都不知道。
执行这三步：
-
composer dump-autoload -o—— 生成优化后的自动加载映射 -
php think optimize:autoload—— TP8 专用命令，会额外扫描服务提供者和 Facade 注册 - 再进 PHP 交互模式验证：
php -a→var_dump(class_exists('app\service\UserService'));
只要第三步返回 bool(true)，后续依赖注入、Facade 调用、模型实例化才真正有了基础。否则所有「绑定」和「注入」都是空中楼阁。
