ThinkPHP自动加载调试技巧_自动加载调试方法【实战】-ThinkPHP-PHP中文网

class not found 报错本质是自动加载未命中预期路径，需三步调试：确认类名与实际实例化类一致、核对命名空间和物理路径严格匹配（含大小写与斜杠）、验证 composer psr-4 映射是否生效且无 loader::addpsr4() 冲突。

thinkphp自动加载调试技巧_自动加载调试方法【实战】

Class not found 报错不是文件丢了，而是自动加载根本没走到你预期的路径——调试核心就三件事：确认类名、核对命名空间、验证 Composer 映射是否生效。

报错信息里写的类名（比如 appcontrollerIndexController）未必是你代码里写的那个。框架在路由解析、模型绑定等环节会动态拼接命名空间，容易出偏差。

在控制器构造函数或 initialize() 里加 echo get_class($this); die;，看实际实例化的是哪个类
用 debug_print_backtrace(); 在报错前打断，看调用栈里传入的类名字符串是什么
检查 URL 路径是否含模块名（如 /admin/index），此时框架默认拼成 appdmincontrollerIndex，而不是 appcontrollerIndex

ThinkPHP 6+ 完全依赖 Composer 的 PSR-4 规则，大小写、斜杠、目录层级必须一字不差。Windows 下能跑通不代表 Linux 上没问题。

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

下载

类文件路径必须是 app/controller/IndexController.php，不能是 app/controller/indexcontroller.php 或 app/Controller/IndexController.php
文件顶部声明必须是 namespace appcontroller;，不能是 namespace AppController; 或漏掉
如果用了自定义目录（如 app/utils/），composer.json 中必须写 "app\utils\": "app/utils/" —— 注意双反斜杠转义和末尾斜杠

改了 composer.json 不运行 composer dump-autoload -o，等于没改；运行了但没清缓存，可能还在用旧映射。

检查 vendor/composer/autoload_psr4.php 文件，搜索你的命名空间前缀（如 'app\utils\'），确认对应路径已写入
线上部署后务必执行 composer install --no-dev --optimize-autoloader，别只本地跑一遍 dump-autoload
删掉 runtime/ 目录再试 —— 某些版本的 ThinkPHP 会把类映射缓存进 runtime/classmap.php，不删它不会重新生成

当所有配置看起来都对，但还是找不到类，最直接的办法是跳过自动加载逻辑，手动验证路径和权限。

在控制器里写：var_dump(file_exists(APP_PATH . 'controller/IndexController.php'));
如果返回 false，检查 APP_PATH 值是否正确（echo APP_PATH;）、目录是否被 .gitignore 排除、Linux 下是否因大小写或权限拒绝访问
临时加一句 require APP_PATH . 'controller/IndexController.php';，如果能加载成功，说明问题 100% 出在自动加载链上，不是文件本身

最容易被忽略的是：Composer 的 PSR-4 映射和 ThinkPHP 自己的 Loader::addPsr4() 共存时，谁先注册谁生效，且不会合并。开发中混用两者，不仔细看初始化顺序，类就时而存在、时而消失。