ThinkPHP自动加载文件不存在_文件不存在排查法【详解】-ThinkPHP-PHP中文网

class not found 错误本质是自动加载失败，非文件缺失；主因是命名空间、目录结构、composer autoload 配置三者不匹配，导致框架无法定位类，即使文件真实存在也会报错。

thinkphp自动加载文件不存在_文件不存在排查法【详解】

Class not found 不是文件丢了，是自动加载机制压根没找对地方。 框架不会满目录扫描 PHP 文件，它只认命名空间、目录结构、composer autoload 配置这三样。只要其中一环错位，哪怕文件真实存在，也会报错。

这是自动加载失败最常打头阵的错误，不是框架坏了，而是入口没对上。

检查 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 这两行

控制器类找不到，90% 是命名空间和物理路径没咬合上。

ThinkPHP5.1企业站点快速开发

下载

文件必须放在 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 段

不在 app/ 下的类，Composer 默认不认，必须显式注册。

在 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 函数本身的问题，而是路径解析或权限卡住了。

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）有读权限，而不仅仅是所有者有