tp6多应用模式报错根源在于扩展未正确安装、app目录残留单应用结构、auto_multi_app未开启及路由未适配：需在项目根目录装think-multi-app，清空app/下所有单应用文件，设config/app.php中'auto_multi_app'=>true，并为各子应用独立配置route/app.php。
TP6 接口多应用模式报错，常见于“控制器不存在”“路由未定义”“Class not found”或空白页，根源基本集中在扩展未装对、目录结构残留、配置缺失、路由未适配
确认 think-multi-app 是否真装进项目
这个扩展不是全局命令，必须装在你的 TP6 项目根目录（含 composer.json、app/、public/ 的那层）：
- 执行
composer require topthink/think-multi-app前，先用cd进入项目根目录，检查是否存在composer.json - 装完后，确认
vendor/topthink/think-multi-app目录真实存在，且composer.json的autoload段已自动加入 PSR-4 映射（无需手动改） - 若提示
Package not found，大概率是路径错了——比如在D:\xampp\htdocs或vendor/topthink/thinkphp里执行了命令
清空 app/ 下所有单应用残留文件
多应用模式下，app/ 不能保留任何单应用结构，否则 TP 启动时仍按单应用逻辑加载，直接报错 Class 'app\controller\Index' not found：
ThinkPHP6.0.0
下载
ThinkPHP 6.0.0 是国产轻量级 PHP 框架的里程碑式版本，于 2019 年正式发布。该版本基于“精简核心”与“统一用法”原则，对底层架构进行了彻底重构。它强制要求 PHP 7.1+ 环境，全面启用强类型声明，深度支持 PSR 规范，并引入了独立的多应用模式、改进的中间件机制及全新的事件系统，标志着 ThinkPHP 正式迈入现代化、标准化与企业级开发的新阶段。
- 删掉
app/index/、app/common.php、app/controller/、app/model/等所有非子应用目录 - 清空后，
app/应只剩空子目录，如app/api/、app/admin/、app/mobile/ - 验证是否清理干净：运行
php think build api，看是否生成app/api/controller/Index.php且命名空间为app\api\controller
必须显式开启 auto_multi_app 并检查入口文件
config/app.php 中的 'auto_multi_app' => true 是硬性开关，不是可选项：
- 该配置必须写在
return []数组内，键名不能拼错（如写成auto_multi_app_或multi_app都无效） - 入口文件
public/index.php必须包含require __DIR__ . '/../vendor/autoload.php';，否则扩展类根本不会加载 - 如果用了自定义入口（如
public/api.php），同样要确保引入了 autoload，并且路由分发逻辑兼容多应用
接口应用的路由和访问方式要单独处理
多应用下，每个子应用（如 app/api/）需独立管理路由，不能复用根路由配置：
- 在
app/api/下新建route/目录，并添加app/api/route/app.php（内容参考官方路由写法） - 接口访问路径必须带应用名，例如
/api/v1/user对应app/api/controller/v1/User.php中的v1\User控制器 - 若启用强制路由（
'url_route_must' => true），所有接口路径都得在对应应用的route/app.php中明确定义，否则报“当前访问路由未定义” - POST 接口在浏览器中直接访问会失败，建议用 Postman 或 curl 测试；GET 接口可临时改成 GET 方便调试
