ThinkPHP自动加载异常处理_自动加载异常捕获【教程】-ThinkPHP-PHP中文网

自动加载异常不是运行时错误，而是类根本未被加载，不触发任何异常处理器，render()和report()均无效；php在解析new或静态调用时若类未找到，直接报fatal error并终止，不生成throwable实例。

thinkphp自动加载异常处理_自动加载异常捕获【教程】

自动加载异常不是运行时错误，而是类根本没被加载进来——它不会触发任何异常处理器，render() 和 report() 都收不到，你写的自定义异常类完全无效。

ThinkPHP 的自动加载失败（如 Class "appcontrollerIndex" not found）发生在 PHP 解析 new 或静态调用时，此时类尚未载入，框架的异常捕获机制还没启动。这和运行中抛出的 Exception 或 Throwable 是两套逻辑。

自动加载阶段失败由 PHP 内置的 spl_autoload_register 链决定，ThinkPHP 6+ 完全交由 vendor/autoload.php 处理
一旦 Composer 的 PSR-4 映射找不到对应文件，PHP 直接报 Fatal error 并终止，不会生成 Throwable 实例
你在 app/exception.php 里重写的 render() 方法，对这种错误毫无感知
日志里也看不到 trace，因为连 report() 都没机会执行

别猜路径、别改配置，直接验证 Composer 是否真认识这个类：

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

下载

运行 composer dump-autoload -o 后，检查 vendor/composer/autoload_psr4.php 是否包含你期望的映射，例如：'app\controller\' => array($baseDir . '/app/controller')
确认类文件物理路径与命名空间严格对齐：app/controller/IndexController.php 必须声明 namespace appcontroller;，不能是 AppController 或 appcontroller（少反斜杠）
在 Linux 环境下，用 ls -l app/controller/ 确认文件名大小写： IndexController.php ≠ indexcontroller.php
临时加一句调试：在 public/index.php 开头插入 var_dump(class_exists('appcontrollerIndexController'));，看是否返回 false

ThinkPHP 不会自动扫描 extend/ 下的类，必须显式注册到 Composer —— 没有例外，也不支持运行时 Loader::addNamespace()（TP6 已移除）：

编辑项目根目录 composer.json，在 "autoload": {"psr-4": {}} 里添加映射，例如："extend\pay\": "extend/pay/"
注意：namespace 键必须以双反斜杠结尾（\），路径值末尾不加斜杠（"extend/pay" ✅，"extend/pay/" ❌）
运行 composer dump-autoload -o，不是 install 或 update，后者不一定重建 autoload 文件
如果类在 extend/pay/v3/PayClient.php，其命名空间必须是 extendpay3，不能简写为 extendpay

开发时常用 composer install --no-dev --optimize-autoloader 打包，但该命令生成的 autoload_classmap.php 是静态快照，不响应后续新增类或 composer.json 修改：

CI/CD 构建后部署到服务器，若没重新运行 composer dump-autoload -o，新类就不可见
本地改了 composer.json 但只执行了 composer install，没加 -o，会导致 PSR-4 映射未更新
某些 Docker 环境挂载代码目录后，vendor/ 是只读的，dump-autoload 实际失败但无提示
验证方式：查看 vendor/composer/autoload_static.php 中的 $prefixLengthsPsr4 是否包含你的命名空间前缀