Composer update 报错“can’t be installed because it conflicts with another package”是因依赖树中某包被间接锁死旧版，而新组件要求更高版本；require/update 会重算依赖图，install 则只复原 lock 文件版本。

ThinkPHP 项目里 composer update 报错“can’t be installed because it conflicts with another package”，基本就是依赖树里某个包被间接锁死在旧版，而新引入的组件（比如 topthink/think-swoole 或 league/flysystem）要求更高版本 —— 不是配置写错了，是 Composer 自动解析时发现逻辑上无法共存。

为什么 composer require 突然失败，但 composer install 没问题？

因为 composer install 只按 composer.lock 复原已有版本；而 require 或 update 会重新计算依赖图。ThinkPHP 官方包（如 topthink/framework）常在 composer.json 中硬性约束某些底层组件（如 psr/log、symfony/var-dumper）的版本范围，一旦你手动加了一个依赖，它又反向要求更高版 PSR 接口，Composer 就卡住。

• 检查 composer show topthink/framework 输出的依赖列表，重点关注 requires 下带 ^ 或 ~ 的项（比如 psr/container: ^1.0）
• 运行 composer prohibits psr/container:2.0（把目标包名换成你实际冲突的），看哪几个包在阻止升级
• ThinkPHP 6.0.x 默认不兼容 psr/container 2.x，但部分生态扩展（如新版 hyperf/utils）已强制要求 2.x —— 这类冲突最常见

composer update 时如何精准放开某包的版本限制？

不能直接删 composer.lock 或盲目加 --with-all-dependencies，那可能连带升级 topthink/framework 到不兼容的大版本。稳妥做法是只松动冲突源头的约束：

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

• 在 composer.json 的 require 块外，加 conflict 字段临时屏蔽干扰项：

  "conflict": {
      "psr/container": "<2.0"
  }

  （注意：这是告诉 Composer “我明确不要旧版”，而非“允许新版”）
• 更推荐用 replace 声明替代关系，例如：

  "replace": {
      "psr/container": "self.version"
  }

  ，再配合安装 psr/container 2.x 的桥接包（如 container-interop/container-interop）
• 如果冲突来自 monolog/monolog，优先尝试 composer require monolog/monolog:^2.0 --with-dependencies，而不是全量 update

ThinkPHP 6 和 Laravel 包混用时的典型兼容陷阱

很多开发者想把 Laravel 的 laravel/scout 或 spatie/laravel-medialibrary 拿到 ThinkPHP 里用，结果爆 Class Illuminate\Support\ServiceProvider not found —— 这不是版本号问题，是自动加载和容器绑定机制不兼容。

立即学习“PHP免费学习笔记（深入）”；

• 这类包严重依赖 Laravel 的 Illuminate 组件和 Application 生命周期，ThinkPHP 的 App 类不实现相同接口
• illuminate/support 7.x+ 已弃用 Manager 基类，但 ThinkPHP 6.0.x 的 think-queue 仍继承它，导致 illuminate/support:^8.0 直接无法载入
• 可行方案只有两个：改写服务提供者（把 Illuminate\Support\ServiceProvider 替换为 think\Service），或用 composer create-project 新建纯 Laravel 项目，通过 API 调用 ThinkPHP 后端

真正麻烦的从来不是报错信息本身，而是 composer.lock 里某一行看似无关的版本号，牵出了三年前某个开发随手加的 dev-master 引用 —— 这种隐式锁定，比明面上的版本冲突更难定位。