ThinkPHP类找不到ClassNotFound报错怎么解决-ThinkPHP-PHP中文网

class not found 根源是自动加载未识别类，需路径、命名空间、composer.json配置、dump-autoload四者严丝合缝：检查命名空间与目录逐级一致（大小写敏感）、入口引入vendor/autoload.php、extend等非默认目录须在composer.json中声明psr-4映射并执行composer dump-autoload -o。

thinkphp类找不到classnotfound报错怎么解决

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，入口文件必须第一行引入它：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

检查 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 -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"]}