TP6跨应用调用类报错主因是自动加载路径断裂、命名空间错位或应用隔离未绕过；需确认类在目标应用目录、路径与namespace严格一致，并通过require_once、容器绑定或composer PSR-4映射显式加载。

TP6跨应用调用类报错，核心是自动加载路径断裂、命名空间错位或应用隔离机制未绕过——不是类不存在，而是框架没找到它该去哪找。

确认类是否在目标应用目录下

TP6多应用模式下，每个应用（如admin、api、home）默认只加载自身目录下的类。若在admin中调用api下的apppiserviceUserService，会直接报Class not found。

• 检查文件物理路径是否真实存在：app/api/service/UserService.php
• 确认命名空间与路径严格一致：namespace apppiservice;（不能写成appservice或漏掉api）
• 多应用项目中，app/下各子目录互不自动包含，需显式引入

手动加载跨应用类的三种可靠方式

不依赖自动发现，用确定性方式拉入类：

• use全限定名 + require_once：在调用处上方写
  require_once app_path() . 'api/service/UserService.php';
use apppiserviceUserService;
• 通过容器绑定（推荐）：在app/common.php或应用初始化逻辑中注册
  Container::getInstance()->bind('api.UserService', UserService::class);
  之后可用app('api.UserService')获取实例
• 在composer.json中扩展autoload：添加自定义PSR-4映射
  "autoload": { "psr-4": { "app\api\": "app/api/" } }，然后运行composer dump-autoload

避免常见陷阱

跨应用调用时高频翻车点：

• 误用Loader::import()：TP6已废弃该方法，调用即报错
• 在中间件或事件中跨应用调用却未初始化对应应用环境：例如admin路由里调api服务，但App::setAppNamespace('app\api')未执行，导致Facade解析失败
• 混淆应用与模块概念：TP6无“模块”概念，只有“应用”，app/module/xxx结构是伪模块，不会被自动加载
• 使用thinkacadeDb等全局Facade没问题，但自定义类必须走上述任一显式路径

调试技巧：快速定位加载失败原因

在报错前加一行诊断代码：

• 查文件是否存在：var_dump(file_exists(app_path() . 'api/service/UserService.php'));
• 查命名空间是否可反射：var_dump(class_exists('app\api\service\UserService'));
• 查自动加载器是否注册：var_dump(get_included_files());确认php文件是否已被载入