TP5.0.24控制器类名不能带Controller后缀，必须为Index；文件名须为Index.php（小写、无.class.php）；命名空间强制为app\index\controller；需use think\Controller；方法必须return响应。
控制器类名不能带 Controller 后缀
TP3.2 中控制器文件是 IndexController.class.php，类名为 IndexController；TP5.0.24 要求类名直接叫 Index，不加后缀。否则框架找不到对应类，报错 Class 'app\index\controller\IndexController' not found。
如果你坚持用 IndexController，必须在配置中开启：'use_controller_suffix' => true，但不推荐——这会让路由、命名空间、自动加载都变复杂，后续升级 TP6 更难对齐。
控制器文件必须小写且无 .class.php 后缀
TP3.2 允许 IndexController.class.php 或 IndexController.php；TP5.0.24 只认 Index.php 这种纯小写、无额外后缀的命名。
常见错误现象：
- 保留
.class.php→ 自动加载失败，Class not found - 文件名大写如
Index.php在 Linux 服务器上可能被忽略（大小写敏感），导致 404 - 用下划线命名如
user_manage.php→ 路由能匹配，但命名空间和类名必须同步为UserManage，易出错
命名空间必须显式声明且与目录严格一致
TP3.2 常省略命名空间或写 namespace Home\Controller;；TP5.0.24 强制要求完整命名空间，格式为 namespace app\模块名\controller;，比如 app\index\controller。
关键点：
-
app\前缀不能漏，哪怕你改了应用目录名，命名空间也得从app\开始 - 模块名（如
index）必须和application/下的子目录名完全一致（包括大小写） - 继承类要改：
use think\Controller;，不是Think\Controller（注意首字母小写）
控制器方法返回值必须 return，不能 echo/print
TP3.2 允许在方法里直接 $this->display() 输出；TP5.0.24 所有控制器方法必须用 return 返回响应，例如：
public function index()
{
$this->assign('name', 'thinkphp');
return $this->fetch(); // 必须 return
}
如果漏了 return，页面可能空白，或后续中间件、钩子无法介入，调试时很难定位。
另外，$this->error() 和 $this->success() 也返回响应对象，不是“跳转指令”，它们内部已封装了 redirect() 或 JSON 输出逻辑，不要在外层再加 exit 或 die。
控制器命名看着只是文件和类名改动，实际牵扯自动加载、路由解析、命名空间映射三层机制。漏掉任意一环，轻则 404，重则类未加载却无报错——尤其在开发环境关了 APP_DEBUG 时，容易误判为“功能没写”。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
