根本原因是Composer未配置PSR-4映射，需在composer.json中添加"appservice": "app/service/"并执行composer dump-autoload -o；同时确保命名空间、路径、文件名大小写完全一致。
ThinkPHP 6+ 里服务类（比如 appserviceUserService）无法自动加载，根本原因不是框架“不支持”，而是它默认不走 Composer PSR-4 加载 —— 除非你明确告诉 Composer：“这个命名空间归我管”。
为什么 new appserviceUserService() 报 Class not found
TP6 不再像 TP5 那样内置 thinkLoader::addNamespace() 自动注册 app 目录；它把控制权完全交还给 Composer。也就是说：app 目录本身不在 composer.json 的 autoload 配置里，就等于对自动加载器“不可见”。
- 错误现象：
Class "appserviceUserService" not found，但文件明明在app/service/UserService.php - 检查点：运行
composer show --platform看不到app命名空间映射 - 关键区别：控制器、模型等由 TP 框架路由/Db 类动态实例化，它们走的是框架内部逻辑；而你手动
new的服务类，只走 Composer 的 PSR-4
在 composer.json 中正确配置 appservice PSR-4 映射
必须编辑项目根目录的 composer.json，不是框架源码里的那个。PSR-4 规则极敏感，大小写、斜杠、路径全错一个就失效。
- 在
"autoload"→"psr-4"下添加："app\service\": "app/service/"（注意双反斜杠转义） - 路径末尾带斜杠，命名空间末尾也必须带反斜杠，两者严格对齐
- 别写成
"App\Service\"或"app/service\"—— 命名空间大小写和路径大小写必须完全一致 - 改完后立刻执行：
composer dump-autoload -o（加-o生成优化映射，开发阶段也建议加，否则可能不生效）
命名空间与文件路径不匹配的典型坑
即使配置了 PSR-4，UserService 还是找不到，90% 是因为物理路径和命名空间声明没对上。
立即学习“PHP免费学习笔记（深入）”；
- 文件路径必须是
app/service/UserService.php，不能是app/Service/UserService.php（大小写错） - 文件顶部命名空间必须是
namespace appservice;，不能漏掉app，也不能写成Appservice或app/service - 类名必须与文件名一致：
class UserService→ 文件名UserService.php，不能是userservice.php或User_service.php - Linux 服务器上大小写敏感，Windows 开发机可能“碰巧”能跑，一上线就报错
不推荐用 Loader::import() 或 addClassMap 补救
有人试过在 common.php 里写 Loader::addClassMap('appserviceUserService', app_path('service/UserService.php'))，这确实能绕过 Composer，但代价明显：
- 每次新增服务类都要手动加一条映射，维护成本飙升
- IDE 无法跳转、PHPStan/PHPStorm 类型推导失效
- 违背 PSR-4 标准，团队协作时别人看不懂你的加载逻辑
-
Loader::import()在 TP6 是兼容层，性能差、不支持命名空间解析，且未来版本可能移除
真正该花时间确认的只有三件事：composer.json 是否配对、文件路径是否小写一致、命名空间声明是否一字不差 —— 其他都是干扰项。
