ThinkPHP项目升级中的依赖库版本升级冲突_Composer依赖解决-ThinkPHP-PHP中文网

composer install报错“your requirements could not be resolved”本质是旧版扩展与tp6+的php版本及依赖约束冲突，需用composer why-not、prohibits排查依赖链，同步更新php版本、配置访问方式、命名空间及扩展兼容性。

thinkphp项目升级中的依赖库版本升级冲突_composer依赖解决

Composer install 报错“your requirements could not be resolved”

这是升级 ThinkPHP 时最常卡住的地方，本质是旧项目里 composer.json 中手动写死的扩展版本（比如 "topthink/think-image": "1.0.*"）和新版 ThinkPHP（如 v6.1+）要求的 PHP 版本、依赖约束不兼容。

实操建议：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

先运行 composer why-not topthink/framework:6.1.0（把版本换成你想升的目标），看哪几个包在拦路
重点检查 require-dev 区域——很多老项目在这里锁了 phpunit/phpunit: ^5.7，而 TP6 要求 ^9.0，直接冲突
别急着删包，先用 composer prohibits vendor/package:version 查清依赖链，比如 composer prohibits guzzlehttp/guzzle:7.0 能快速定位谁在拖后腿
PHP 版本必须匹配：TP6.1 要求 PHP >= 7.2，但如果你用的是 8.1+，某些旧扩展（如 topthink/think-migration v1.x）会因反射调用报 Deprecated: Return type of think\migration\Command::configure()

ThinkPHP 5.1 升 6.x 后 `config('database')` 返回 null

不是配置没读到，是 TP6 彻底移除了全局函数 config()，所有配置访问必须走容器或助手函数 think_config()（仅限兼容模式），且配置文件结构也变了。

实操建议：

确认是否启用了 think-swoole 或 think-worker——它们可能缓存了旧版配置实例，重启服务进程比改代码还管用
TP6 的数据库配置默认在 config/database.php，但实际加载入口是 app/provider.php 里的 think\provider\ConfigProvider，如果自定义过 Provider，要同步更新 register() 方法
别直接复制 TP5 的 database.php 过来——TP6 要求必须返回数组，且键名严格为 default、connections，少一个就静默失败
调试时用 app()->make('config')->get('database.connections.mysql.host') 比 config() 更可靠，能避开函数未定义错误

升级后 `vendor/bin/think` 命令执行报 `Class 'think\Console' not found`

TP6 把命令行核心类从 think\Console 搬到了 think\console\Console，同时入口脚本 think 本身也重构了，旧版启动器还在找老命名空间。

实操建议：

删掉根目录下旧的 think 文件，重新运行 composer dump-autoload，再执行 php think list——新版会自动生成正确入口
如果你在 server.php 或 Swoole 启动脚本里手动 new 了 think\Console，全部替换成 think\console\Console
自定义命令类必须继承 think\console\Command，且构造方法里不能漏掉 parent::__construct($name)，否则 think list 不显示该命令
TP6.2+ 开始，think 脚本默认启用 Composer 自动加载，如果项目用了 apcu 缓存 opcache，记得清一下 apcu_clear_cache()，否则可能加载到旧类定义

第三方扩展（如 `topthink/think-queue`）无法适配 TP6

很多扩展作者没及时更新，导致 composer require topthink/think-queue 安装的是 TP5 分支，与 TP6 的事件系统、容器契约不兼容，典型表现是 Queue::push() 报 Call to undefined method think\Queue::push()。

实操建议：

优先查 Packagist 页面，看扩展最新版是否标明支持 thinkphp ^6.0；若没有，别硬装，去 GitHub 看 develop 或 v3.0 分支有没有 TP6 兼容提交
临时方案：在 composer.json 中用 repositories 指向 fork 后的修复版，例如：
```
"repositories": [{"type": "vcs", "url": "https://github.com/xxx/think-queue"}]
```
注意扩展的 service_provider 是否已注册——TP6 要求在 app/provider.php 手动追加，不像 TP5 那样自动扫描
有些扩展（如 topthink/think-captcha）在 TP6 下必须配合 think-view 使用，单独装会因模板引擎缺失报错，这个坑容易被忽略