ThinkPHP 6控制器必须放在app/controller目录下，类名与文件名严格一致且首字母大写，命名空间为app\controller，须继承BaseController才能使用assign()等方法，否则报错或静默失败。
ThinkPHP 6.0 创建控制器不是“建个文件就能用”，错一个点——比如路径、命名空间、继承关系或生命周期调用时机——就会 404、Class not found、$this->assign() 报错，或者方法静默不执行。
控制器文件放哪？命名和类名怎么写才不报错
必须放在 app/controller/ 目录下（单应用），不能是 app/Controller 或 app/controllers；多应用时路径为 app/{app_name}/controller/。
- 文件名必须首字母大写、不带
Controller后缀：想访问/user/profile，文件就得叫User.php，不是UserController.php或user.php - 类名必须与文件名完全一致：
User.php→class User，不能是class UserController - 命名空间必须是
app\controller（单应用）或app\{app_name}\controller（多应用），漏掉app\前缀会加载失败 - 如果改过应用目录名（如把
app改成src），必须同步更新config/app.php中的app_namespace配置项
控制器类必须继承 BaseController 才能用 assign() 和 fetch()
直接写 class Index { public function index() { $this->assign('name', 'tp6'); } } 会报 Call to undefined method —— 因为 assign()、fetch()、redirect() 这些方法只在基类里提供。
- 必须继承
app\BaseController（TP6 推荐）或\think\Controller（兼容写法） - 如果你自定义了
app\BaseController，请确认它已正确继承\think\Controller，否则快捷方法全部失效 - 不继承基类也能跑，但得手动 new View、调用 render，代码冗长且易出错
为什么 index() 不执行？__invoke 和路由绑定的关系
ThinkPHP 默认响应 URL（如 /index/index）时，调用的是控制器的 index() 方法，不是 __invoke()。即使你实现了 __invoke，框架也不会自动触发它。
立即学习“PHP免费学习笔记（深入）”；
-
__invoke()是 PHP 的可调用对象机制，ThinkPHP 不默认启用它作为入口方法 - 想用
__invoke，必须显式绑定路由：Route::get('test', 'Index')，此时访问/test才会调用__invoke() - 但常规 URL（如
/index或/index/index）仍走index()，和__invoke完全无关 - 混淆这两者，会导致“写了方法却没反应”，且无任何错误提示，纯静默失败
构造方法里别碰 $this->request，initialize() 才是正解
控制器实例化时，$this->request、$this->app 等核心对象尚未注入，$this->request->param() 会直接报 Call to a member function param() on null。
- 所有初始化逻辑（如权限检查、公共参数获取、中间件依赖）必须写在
initialize()方法里，这是 TP6 提供的标准钩子 -
initialize()在对象构建完成、依赖注入完成后自动调用，此时$this->request可安全使用 - 依赖注入（如
public function index(\think\Request $request)）也受此生命周期约束，乱序操作会让依赖“时有时无”
最常被忽略的是命名空间和继承关系的组合效应：文件位置对了、类名对了、方法也 public 了，但只要没继承 BaseController 或命名空间少了个 app\，整个控制器就变成“不可见的黑盒”。调试时先盯死这两点，比翻路由配置更省时间。
