Class not found 错误本质是自动加载失败，非文件缺失；主因是命名空间、目录结构、composer autoload 配置三者不匹配，导致框架无法定位类，即使文件真实存在也会报错。
Class not found 不是文件丢了，是自动加载机制压根没找对地方。 框架不会满目录扫描 PHP 文件，它只认命名空间、目录结构、composer autoload 配置这三样。只要其中一环错位，哪怕文件真实存在，也会报错。
Class 'thinkApp' not found 的典型排查点
这是自动加载失败最常打头阵的错误，不是框架坏了，而是入口没对上。
- 检查
vendor/composer/autoload_classmap.php里有没有thinkApp的映射行 —— 没有就说明composer dump-autoload没跑，或者composer install被跳过了 - 确认
composer.json的"psr-4"配置里是否包含"topthink\": "vendor/topthink/thinkphp/src/"，漏掉或拼错都会导致核心类无法加载 - Windows 下编辑过
composer.json或配置文件？用 VS Code 打开，右下角切到UTF-8 with BOM→ 改成UTF-8 without BOM，BOM 会干扰 JSON 解析，导致 autoload 配置读取失败 - Nginx 环境下访问
public/index.php报这个错，但 CLI 下php think hello正常？大概率是PATH_INFO没透传，检查 Nginx 配置里有没有fastcgi_split_path_info和fastcgi_param PATH_INFO这两行
appcontrollerUserController not found 的路径与命名空间校验
控制器类找不到，90% 是命名空间和物理路径没咬合上。
- 文件必须放在
app/controller/UserController.php（注意是controller小写，不是Controller或controllers） - 文件顶部必须是
namespace appcontroller;（结尾无空格、无多余反斜杠、全部小写） - 类名必须严格等于文件名：文件叫
UserController.php，类就必须是class UserController；usercontroller.php或UserController.PHP在 Linux 上直接失效 - 如果用了子目录如
app/controller/api/User.php，命名空间就得是appcontrollerpi，不能省略api段
自定义类或 extend 目录下的类不生效
不在 app/ 下的类，Composer 默认不认，必须显式注册。
立即学习“PHP免费学习笔记（深入）”；
- 在
composer.json的"autoload": {"psr-4": {}}里加一行，比如"addon\": "extend/addon/"，然后必须执行composer dump-autoload - 别把
"app\": "app/"写成"appcontroller\": "app/controller/"—— 后者会覆盖前者，导致整个app/目录其他子命名空间（如appmodel）失效 - ThinkPHP 6.x 已移除
Loader::addNamespace()，运行时手动注册命名空间的方式不再起作用，全靠 Composer 静态映射 - 临时验证：在
public/index.php开头加var_dump(class_exists('addonservicePayService'));，返回false就说明 autoload 没覆盖到
文件存在但 require 失败的底层原因
不是 require 函数本身的问题，而是路径解析或权限卡住了。
- PHP 的相对路径基于
getcwd()，不是文件所在目录 —— 在命令行执行php think make:controller Test时，当前工作目录可能在项目根，也可能在public/，导致路径错乱 - 统一用
__DIR__构造路径：require __DIR__ . '/../config/database.php';，避免依赖动态工作目录 - 检查
open_basedir是否启用：echo ini_get('open_basedir');，如果输出非空且不包含你的配置文件路径，require必然失败 - Linux 下确认文件权限：
ls -l app/controller/UserController.php，确保 web 用户（如 www-data）有读权限，而不仅仅是所有者有
真正容易被忽略的是：autoload 映射一旦生成，就不会自动更新。改了命名空间、挪了文件、加了新目录，不手动跑 composer dump-autoload，框架永远“看不见”它。别指望清缓存、重启 PHP-FPM 或删 runtime/ 能解决这个问题。
