控制器404主因是框架未加载类，需检查四点：路径（必须app/controller）、命名（文件名=类名=小写首字母大写）、命名空间（严格app\controller）、生命周期（用initialize()而非__construct()初始化）。
控制器建不对，90% 的 404 和静默失败都出在这四点：路径、命名、命名空间、生命周期。不是代码写错了，是框架根本没找到你写的类，或者找到了但没在正确时机调用它。
控制器文件必须放在 app/controller 目录下
ThinkPHP 6+ 默认只从 app/controller 自动加载控制器，放错位置就等于没写。常见错误包括：
- 误建在
app/Controller（首字母大写）或app/controllers（复数形式）——系统不识别 - 改过应用目录名（比如把
app改成src），但没同步改config/app.php里的app_namespace配置项 - 在 ThinkPHP 5 中误放到
application/index/controller，而项目实际是 TP6+ 结构
验证方式：直接访问 http://localhost:8000/index/index，如果报 404 或 Class not found，先检查这个路径是否真实存在且可读。
类名、文件名、命名空间三者必须严格对齐
TP6+ 要求三者完全一致，差一个字母或大小写都会失败：
- 文件名必须是
Index.php（首字母大写，无后缀如.class.php） - 类名必须是
Index（不能是index、IndexController或IndexCtrl） - 命名空间必须是
app\controller（不能漏app\，不能写成App\Controller或app/controller）
示例正确结构：
<?php namespace app\controller;
class Index
{
public function index()
{
return 'ok';
}
}注意：TP8 仍沿用此规则，不支持 PSR-4 外的任意映射；IndexController 这种命名只存在于 TP3.2 或部分旧模块化项目中，新项目请勿套用。
构造方法里别碰 $this->request，用 initialize()
__construct() 执行时，$this->request、$this->app 等对象还没注入，此时调用会返回 null 或触发 Call to a member function param() on null 错误。
- 所有初始化逻辑（如权限检查、公共参数预处理）应移到
initialize()方法里 -
initialize()是框架提供的钩子，在依赖注入完成后自动执行，此时$this->request->param()才真正可用 - 中间件、服务绑定等也依赖这个顺序，乱序会导致“有时能用、有时报错”的诡异现象
错误写法：
public function __construct()
{
parent::__construct();
$this->uid = $this->request->param('uid'); // ❌ 此时 $this->request 是 null
}
正确写法：
protected function initialize()
{
$this->uid = $this->request->param('uid'); // ✅ 安全可用
}
方法参数不会自动绑定，input() 和路由变量才是正解
ThinkPHP 不支持 Laravel 风格的类型提示自动注入，public function detail($id) 中的 $id 不会从 URL 或查询参数自动填入。
- 获取 GET 参数：用
input('id')或input('id/d', 0)（带默认值和类型转换） - 接收 JSON 请求体：必须显式指定
input('', '', null, 'json')，或用$this->request->param() - 想让 URL 路径参数（如
/user/123）进方法参数，需配置路由变量：Route::get('user/:id', 'User/detail')，并确保开启「变量自动解析」（默认开启，但若关了就无效）
特别注意：__invoke 方法不会被默认调用——即使类实现了它，/index 访问的仍是 index() 方法；要用 __invoke，必须显式绑定路由：Route::get('test', 'Index')。
最常被忽略的是命名空间与目录的映射关系，以及 initialize() 和 __construct() 的调用时机差异。这两处一旦出错，现象都是“代码写了但没反应”，排查时容易反复检查逻辑，却绕开真正的加载链路问题。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
