Class not found 是类未被 PHP 加载，根本未进入容器流程；需确保文件名、类名、命名空间三者首字母大写严格一致，并执行 composer dump-autoload -o 刷新映射，用 class_exists() 验证返回 true。
Class not found 会直接卡在容器注入之前
不会“影响”容器，而是根本进不到容器那一步。ThinkPHP 的服务容器（think\Container）只负责实例化已加载的类；如果 ReflectionException: Class app\controller\IndexController does not exist 报出来，说明 PHP 连类定义都没读到，Container::make() 根本没机会执行。
Linux 下大小写错一个字母，容器连 bind() 都不认
常见错误场景：你在 app/provider.php 里写了 $app->bind(\app\service\UserService::class, \app\service\MysqlUserService::class);，但实际文件是 app/service/userservice.php，类名是 class userservice —— 这时 Container::bind() 不报错，但后续调用 $app->make('app\service\userservice') 会立刻抛 ReflectionException。
- 原因：bind 时只存字符串，不做类存在性校验；真正反射是在 make 时才触发
- Windows 开发时可能侥幸跑通，因为文件系统不区分
userservice.php和UserService.php；一上 Linux 就崩 - 解决方法：用
class_exists('app\service\UserService')手动验证，返回false就说明命名空间或路径有大小写偏差
控制器类大小写错，路由层就断了，根本碰不到容器
ThinkPHP 路由匹配后，会根据配置的控制器类名（比如 app\controller\Index）去调用 Container::make()。但如果 app/controller/index.php 文件里写的是 class index，而命名空间是 namespace app\controller;，那么 class_exists('app\controller\index') 返回 false，框架直接抛出 ClassNotFoundException，连容器初始化逻辑都跳过。
- 典型错误信息：
Class "app\controller\index" does not exist（注意小写index） - 关键检查点：文件名
Index.php、类名class Index、命名空间namespace app\controller;三者首字母必须全部大写且严格一致 - 别依赖 IDE 自动生成命名空间——它可能把
app/controller/api/User.php错生成为namespace app\controller\api;（少个空格或斜杠）
为什么 dump-autoload -o 后还报错？可能是大小写缓存残留
Composer 的优化自动加载（-o）会把类名映射固化进 vendor/composer/autoload_classmap.php。如果你之前建过 app/controller/user.php（小写），再改成 User.php（大写），但没删掉旧的 classmap 条目，就会导致 class_exists('app\controller\User') 仍返回 false。
立即学习“PHP免费学习笔记（深入）”；
- 操作建议：删掉
vendor/composer/autoload_*.php全部文件，再跑composer dump-autoload -o - 验证命令：
php -r "var_dump(class_exists('app\controller\User'));"，必须返回true才算过关 - 容易被忽略的一点：Nginx/Apache 缓存了 404 响应，浏览器看到的还是旧错误页；要清服务器端响应缓存，或加时间戳参数测试
