Class not found 根源是自动加载未识别类，需路径、命名空间、composer.json配置、dump-autoload四者严丝合缝：检查命名空间与目录逐级一致（大小写敏感）、入口引入vendor/autoload.php、extend等非默认目录须在composer.json中声明PSR-4映射并执行composer dump-autoload -o。
ThinkPHP 报 Class not found，不是类文件丢了，也不是代码写错了，而是自动加载机制没“认出”这个类——路径、命名空间、composer.json 配置、运行时映射四者只要有一处不匹配，就会触发这个错误。
检查命名空间和目录结构是否完全一致
ThinkPHP 严格遵循 PSR-4 规范，要求命名空间与物理路径逐级对应，大小写、斜杠、层级一个都不能错：
- 如果类在 app/service/UserService.php，命名空间必须是 namespace appservice;（注意双反斜杠），不能写成
app/service、AppService或appservice（末尾多反斜杠） - Linux 服务器区分大小写：
UserService.php≠userservice.php，开发时用 Windows 测试没问题，一上线就报错 - 类名必须与文件名一致：
class UserService对应UserService.php，不能是class userservice或class UserService1
确认 Composer 自动加载是否生效
ThinkPHP 6+ 完全依赖 vendor/autoload.php，入口文件必须第一行引入它：
- 检查 public/index.php 开头是否有：
require __DIR__ . '/../vendor/autoload.php'; - 如果把类放在
extend/或自定义目录（如lib/），必须在composer.json的"autoload": {"psr-4": {}}中手动添加映射，例如："lib\": "lib/" - 改完
composer.json或新增类目录后，必须执行：composer dump-autoload -o（-o表示生成优化版映射，TP5.0.16 及以上推荐加）
验证类文件本身是否可用
即使路径和命名空间都对，文件本身也可能导致加载失败：
立即学习“PHP免费学习笔记（深入）”；
- 用命令行检查语法：
php -l app/service/UserService.php，语法错误会导致类无法注册 - 确认文件真实存在且权限可读：
ls -l app/service/UserService.php，Web 服务用户（如www-data）需有读取权限 - 如果类使用了空命名空间、下划线类名或函数式 SDK（如支付宝 AopClient.php），不能走 PSR-4，应改用
"files"加载方式："autoload": {"files": ["extend/alipay/aop/AopClient.php"]}
排除框架初始化时机干扰
有些报错看似是类找不到，实际是调用时机不对：
- 不要在
config/文件里直接 new 自定义类（如new MyHelper()），配置阶段 autoload 尚未就绪 - 临时注释掉
app/common.php和app/tags.php中所有new或use，看错误是否消失 - ThinkPHP 8 默认不通过容器创建控制器，控制器构造函数里的类型提示不会被注入；改用
initialize()方法做初始化更稳妥
