thinkphp 5 和 6 必须物理隔离共存，各自独立项目目录与 vendor，禁止混装；自动加载、路由、数据库主从等机制完全不兼容，强行复用会导致类加载失败、404、主从失效等运行时错误。
ThinkPHP 5 和 6 共存时，vendor 目录怎么不互相污染
共存的前提是物理隔离，不是“一个项目里切版本”，而是多个独立入口各自加载对应版本的框架。常见错误是把 thinkphp5 和 thinkphp6 都塞进同一个 vendor，结果 composer install 直接报冲突或覆盖自动加载。
实操建议：
- 每个版本单独建项目目录（如
tp5-api/、tp6-admin/），各自运行composer create-project - 禁止在父目录下统一
composer.json管理多个 TP 版本 —— Composer 不支持同名包多版本并存于同一vendor - 如果必须共享部分业务代码（如
app/common），用 Git Submodule 或软链接方式复用，但确保各项目autoload只扫自己路径，不跨项目扫描 -
TP5的think命令和TP6的think命令二进制文件名相同，放在不同bin路径下，调用时用绝对路径或重命名避免混淆
TP5 的 Loader::addNamespace() 和 TP6 的 Composer::getAutoloader() 混用会怎样
不会“混用成功”，只会加载失败或静默跳过。TP5 的自动加载注册逻辑依赖 think\Loader 类的静态方法，而 TP6 已完全移交到 Composer 原生 PSR-4，Loader::addNamespace() 在 TP6 中根本不存在；反之，在 TP5 中调用 Composer::getAutoloader() 会抛出 Class 'think\Composer' not found。
典型错误现象：
- 把 TP6 的扩展包（如
topthink/think-swoole）直接 require 到 TP5 项目中，启动时报Interface 'think\App' not found - 在 TP5 的
common.php里尝试调用 TP6 风格的app()->bind()，结果是Fatal error: Uncaught Error: Call to undefined method think\App::bind() - 手动修改
vendor/composer/autoload_psr4.php强行注入另一版本的命名空间映射，导致类加载顺序错乱，某些类被旧版本覆盖
路由定义写法差异导致 TP5 升级到 TP6 后 404
不是语法报错，而是请求根本没进控制器 —— 因为 TP6 默认关闭了“URL 自动解析控制器/操作”模式，而 TP5 默认开启。你写的 http://site/index/index 在 TP5 能访问 IndexController@index，在 TP6 就直接 404。
关键参数差异：
- TP5：
'url_route_must' => false（允许无路由规则匹配）；TP6：'route_check' => true（强制走路由定义，否则 404） - TP5 的
route.php支持闭包定义；TP6 的route/app.php必须用Route::get()等显式方法注册 - TP6 默认不解析
__construct参数（依赖注入需显式声明），TP5 则默认尝试注入，容易造成构造函数执行时机差异引发异常 - TP5 的
url函数生成地址基于模块/控制器/操作三段式；TP6 默认只认路由别名，没定义别名就生成不了正确 URL
数据库连接配置中 deploy 和 readwrite_separation 在 TP6 是否还有效
无效。TP6 彻底移除了 deploy 配置项，也废弃了 readwrite_separation 的内置主从识别逻辑。TP5 里靠 'deploy' => 1 + 'rw_separate' => true 就能自动分发读写，TP6 必须手动实现 Connection 子类或使用中间件控制连接实例。
兼容性影响：
- TP5 的
database.php直接复制到 TP6 项目中，Db::connect()会忽略deploy字段，所有查询都走默认连接，主从失效 - TP6 的
think\db\Connection不再有switchReadPdo()方法，原逻辑需改写为自定义PDO实例池 + 请求生命周期钩子 - 如果你用了第三方读写分离扩展（如
topthink/think-multiplex），确认它是否已适配 TP6.3+ 的ConnectionInterface，否则运行时报Call to undefined method think\db\Connection::getReadPdo()
多版本共存最麻烦的从来不是装几个包，而是当两个版本的底层契约（比如自动加载机制、路由解析时机、连接管理粒度）发生不可逆偏移时，你以为的“复用”其实正在悄悄破坏运行时一致性。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
