class not found 错误本质是 psr-4 命名空间声明与物理路径不匹配；路由注册成功却 404 是因类未加载；call to undefined function 多因命名空间污染或末尾反斜杠缺失；修改 app_namespace 必须同步 autoload、控制器 namespace 和路由引用，否则全链断裂。
Class not found 错误直接暴露命名空间错位
最典型的表现就是 Class 'App\Controllers\Home' not found 这类致命错误，哪怕文件明明存在、类名也首字母大写。根本原因不是文件没放对，而是 PSR-4 加载器按 APP_NAMESPACE 和 $psr4 映射去拼路径时，发现命名空间声明和物理路径不匹配——比如你写了 namespace App\Controllers\Admin;，但文件却放在 app/Controllers/ 根目录下，加载器就会去 app/Controllers/Admin/Home.php 找，自然扑空。
路由能注册但访问 404，实际是类根本没加载成功
你可能在 app/Config/Routes.php 里写了 $routes->get('admin/dashboard', 'Admin\Dashboard::index');，路由表也显示注册成功，但一访问就 404。这不是路由没生效，而是框架压根没把 Admin\Dashboard 当作一个可实例化的类——因为它的命名空间声明（如 namespace App\Controllers;）和文件路径（app/Controllers/Admin/Dashboard.php）不一致，导致类未被自动加载，后续连方法是否存在都无从判断。
控制器方法执行时突然报“Call to undefined function”
这类错误常被误判为 helper 没加载，其实根源可能是命名空间污染：比如你在控制器里写了 namespace App\Controllers;，但又在同个文件里手动 use App\Helpers\SomeHelper;，而 helper 本身是全局函数、不该有命名空间。更隐蔽的是，如果控制器命名空间写成 App\Controllers\（末尾缺反斜杠），PHP 可能错误解析 helper_function() 的调用上下文，把它当成 App\Controllers\helper_function() 去找，结果报 Call to undefined function App\Controllers\helper_function()。
修改 APP_NAMESPACE 后大面积报错，三处没同步
一旦你动了 app/Config/Constants.php 里的 define('APP_NAMESPACE', 'MyApp')，必须同步改三处：
-
app/Config/Autoload.php中的$psr4['MyApp\'] = APPPATH;（注意末尾反斜杠） - 所有控制器文件顶部的
namespace MyApp\Controllers;（子目录要补全，如MyApp\Controllers\Admin;） - 所有路由中对控制器的引用，比如
'Admin\Users::index'要保持前缀一致
漏掉任意一项，都会让加载器在某个环节断链，错误表现可能五花八门，但本质都是命名空间契约被打破。最麻烦的是错误堆栈不直接提示“你 namespace 写错了”，而是抛出下游症状，比如找不到视图、session 失效、数据库连接失败——因为父类 Controller 都没正确初始化。
