class not found 是 psr-4 自动加载路径配置错误所致，常见于命名空间与文件路径不匹配、大小写不符、斜杠方向错误、composer.json 配置缺失或未执行 composer dump-autoload -o。
Class not found 是自动加载没对上路标，不是文件丢了
ThinkPHP 5.1 报 Class not found，99% 的情况是 PSR-4 自动加载机制“迷路”了——它按命名空间去磁盘找文件，但路径、大小写、斜杠方向或 composer 配置里少一个字符，就直接放弃。你确认文件存在、语法正确、IDE 也没报错，但运行时崩，大概率就是这个原因。
- Linux 服务器区分大小写：
app/controller/IndexController.php和app/controller/indexcontroller.php是两个文件，后者会导致Class appcontrollerIndexController not found - 命名空间末尾必须带反斜杠：
namespace appcontroller;合法，namespace appcontroller（缺分号前的）或namespace app/controller;（正斜杠）都会失败 - 文件名必须与类名完全一致：
class IndexController→ 文件必须叫IndexController.php，不能是indexcontroller.php或Index.php
composer.json 的 psr-4 映射必须显式声明且格式精准
TP5.1 不再扫描 extend/ 或自定义目录，所有第三方类或非 app/ 下的模块，都得靠 composer.json 里的 "psr-4" 明确告诉 Composer：“这个命名空间对应这个路径”。漏配、路径错位、多空格，全都会导致类找不到。
- 检查
composer.json中是否包含："autoload": { "psr-4": { "app\": "app/" } }—— 注意双反斜杠转义和结尾斜杠 - 若引入第三方 SDK（如
alipay/aop），需额外加映射："Alipay\Aop\": "extend/alipay/aop/"，路径必须真实存在且可读 - 改完
composer.json后，必须执行：composer dump-autoload -o，不加-o也能用，但加了更可靠；不执行这步，新配置永远不生效 - 避免混用：
require_once手动引入 + Composer 自动加载，极易触发Cannot redeclare class
runtime 缓存和 IDE 补全容易掩盖真实问题
runtime/ 目录下的缓存不会自动感知命名空间变更，IDE 自动补全的 use 语句也可能来自旧索引，这两者会让问题延迟暴露或误导排查方向。
- 清空
runtime/下全部内容（尤其是cache/、log/、temp/），再试一次，排除缓存干扰 - 删掉报错行的
use语句，手动重写一遍，比如写use appcontrollerIndexController;，别依赖 IDE 自动提示补全 - 打开报错堆栈里提到的具体文件（如
app/controller/IndexController.php），逐字核对三处：namespace声明、文件物理路径、调用处use语句，三者必须一字不差
Loader::addNamespace() 是备选方案，但有兼容性陷阱
虽然 TP5.1 支持运行时注册命名空间，比如在 public/index.php 中框架初始化前调用 Loader::addNamespace('addon', '../addon/')，但它绕过了 Composer，且在 TP6 中已被移除。用它等于主动放弃标准加载路径，后续升级成本高。
- 仅在临时调试或插件场景下使用，不要作为主加载方式
- 必须在
thinkphp/base.php加载之后、App::run()之前调用，否则无效 - 该方式每次请求都走动态查找，性能低于 Composer 的静态映射，线上环境慎用
- 如果已用此方式，记得同步删除
composer.json中对应 PSR-4 配置，避免双加载冲突
composer dump-autoload -o 后没验证生成的 vendor/composer/autoload_psr4.php 是否真包含了你的命名空间映射——打开它看一眼，比猜半天更省时间。php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
