thinkphp service类报class not found的根本原因是自动加载机制未识别，需严格校验命名空间、路径、composer配置及缓存四者一致性。
Service 类报 Class not found，基本不是类文件丢了，而是 ThinkPHP 的自动加载机制压根没“看见”它——命名空间、路径、composer 配置、缓存四者只要有一处对不上，就会静默失败。
命名空间与文件路径必须完全一致
ThinkPHP 6+（含 FastAdmin）严格按 PSR-4 规则加载，appserviceUserService 必须对应 app/service/UserService.php，差一个字母大小写、多一斜杠、少一层目录都会崩。
-
app/service/userservice.php→ Linux 下等同于另一个文件，class_exists('appserviceUserService')返回false - 命名空间写成
appservice（缺反斜杠）或AppService（大小写错）都不行 - 文件里声明
class UserService，不能是class userservice或class UserService1
composer.json 的 psr-4 映射必须存在且正确
默认 TP 项目只映射 "app\": "app/"，但如果你把 Service 放在 app/common/service/ 或 extend/service/，就必须手动加进 composer.json：
"autoload": {
"psr-4": {
"app\": "app/",
"extend\": "extend/"
}
}
改完后必须执行：
-
composer dump-autoload -o（加-o强制生成优化版映射） - 别只清
runtime/cache或重启 PHP-FPM，它们不重建 autoload 表 - 检查
vendor/composer/autoload_psr4.php里有没有你新增的映射项
FastAdmin / TP5 常见陷阱：同命名空间重复 use
在 apppiservicesOrderServices.php 中写 use apppiservicesServices; 是典型错误——当前命名空间已经是 apppiservices，再 use 同名空间下的类，会触发 TP5 自动加载器解析冲突，导致它去错地方找（比如反向查 appcommonservicesServices）。
- 删掉所有
use apppiservicesXxx;这类冗余引入 - 继承时直接写
class OrderServices extends Services - 如果基类在别的命名空间（如
appcommonservicesBaseService），才需要use appcommonservicesBaseService;
扩展类（如 WeChatPay）不在 vendor 时怎么加载
手动丢进 extend/wechat/ 的 SDK，默认不会被自动加载。不能靠 require_once 硬引，得走正规路径：
- 优先用
composer require wechat/pay安装（推荐） - 若必须放
extend/，在public/index.php最开头（vendor/autoload.php之后、框架启动前）加：thinkLoader::addNamespace('WeChat', __DIR__ . '/../extend/wechat/src'); - 确保
extend/wechat/src/PayService.php里声明的是namespace WeChatPayService;，和目录结构严格对应
最常被忽略的一点：改完命名空间或移动了文件，不运行 composer dump-autoload -o，class_exists() 就永远是 false——后续所有依赖注入、模型绑定、服务调用，全都会在看不见的地方失效。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
