自动加载异常不是运行时错误，而是类根本未被加载，不触发任何异常处理器，render()和report()均无效；PHP在解析new或静态调用时若类未找到，直接报Fatal error并终止，不生成Throwable实例。
自动加载异常不是运行时错误，而是类根本没被加载进来——它不会触发任何异常处理器，render() 和 report() 都收不到，你写的自定义异常类完全无效。
Class not found 根本不走异常处理流程
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()都没机会执行
如何快速定位 autoload 失败点
别猜路径、别改配置，直接验证 Composer 是否真认识这个类：
- 运行
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
extend/ 或自定义目录类加载失败怎么办
ThinkPHP 不会自动扫描 extend/ 下的类，必须显式注册到 Composer —— 没有例外，也不支持运行时 Loader::addNamespace()（TP6 已移除）：
立即学习“PHP免费学习笔记（深入）”；
- 编辑项目根目录
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，其命名空间必须是extendpay 3，不能简写为extendpay
线上环境 autoload 生效但本地不生效？检查优化模式
开发时常用 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是否包含你的命名空间前缀
真正麻烦的从来不是写错一行命名空间，而是你以为它“应该能加载”，结果它连进异常流程的门槛都没迈过——autoload 失败没有回调，没有钩子，只有沉默的 Fatal error 和空荡荡的日志。
