thinkphp5报错本质是配置、路径、调用或环境不匹配，集中于路由、模板、数据库、环境变量、异常处理五环节；错误堆栈明确指向根因，需按顺序逐层排查。
ThinkPHP5 报错不是框架“坏了”，而是它在告诉你：某处配置、路径、调用或环境没对上。绝大多数问题集中在路由、模板、数据库、环境变量和异常处理这五个环节，且往往有明确的错误堆栈指向。
找不到控制器：命名空间、文件名、路由三者必须咬死
报错典型信息：controller not exists: app\controller\Index 或直接 404。这不是服务器问题，是框架加载器找不到类。
- 检查
app\controller\Index.php文件是否存在，文件名必须首字母大写（Index.php，不是index.php） - 确认类定义里写了正确的命名空间：
namespace app\controller;，不能漏掉app\或写成app/controller - 类名必须与文件名严格一致：
class Index extends \think\Controller，不能是index或IndexController - 如果用了自定义路由，检查
route/route.php里是否把'/'映射到了'index/index'，而你的控制器实际叫Home.php
include(): Filename cannot be empty：.env 或配置解析崩了
这个致命错误几乎只出现在 ThinkPHP 5.1+，表面是 include() 调用失败，本质是框架在拼接模板路径、异常页面路径或配置文件路径时得到了空字符串。90% 源于 .env 文件格式不合规。
-
.env中任何值含#符号（如DATABASE_PASSWORD=abc#123）会被 phpdotenv 当作注释截断，导致该变量为空 → 后续依赖它的路径拼接失败 -
.env值前后有不可见空格（尤其 Windows 编辑器保存后），APP_DEBUG = true实际是APP_DEBUG = true（末尾空格），phpdotenv 不会 trim，值被识别为"true "，某些配置解析逻辑可能出错 - 运行
php think clear清除所有缓存后仍报错？立刻检查runtime/目录权限，尤其是runtime/config/是否可写 —— 若无法写入缓存配置，框架每次都要重新解析.env，错误会被放大
模板渲染失败：fetch() 返回 false 而不是内容
常见现象是页面空白，或报错 Call to a member function fetch() on boolean。根本原因是 $this->fetch() 没找到对应模板，返回了 false，但你又对这个 false 调用了链式方法（比如 ->assign()）。
- 确认模板文件路径正确：
return $this->fetch('index');对应的是application/view/index/index.html，不是application/view/index.html - 不要在未继承
\think\Controller的类里用$this->fetch()；如果用return view('index');，确保传入的是字符串，且模板存在 - 开启
app_debug = true后，框架会在日志里明确记录“template not exists: xxx”，直接去runtime/log/翻最新日志比猜快得多
Db::name() 查询报错：表前缀、字段名、SQL 构建顺序
像 Call to a member function paginate() on boolean 或 SQLSTATE[42000]: Syntax error... 这类错误，通常不是数据库连不上，而是查询语句构造中途就中断了。
-
Db::name('user')默认会自动加上配置里的prefix，但如果数据库表没加前缀，而配置写了'prefix' => 'tp_'，就会查tp_user表 → 找不到表 → 返回false - 使用
where()时漏写条件键名，比如where('status', 1)是对的，但where(1)或where(['status' => 1])写成where([1])会导致语法错误 -
paginate()必须作用于查询对象，不能跟在原生query()或execute()后面 —— 它们返回的是 int 或 bool，不是 Query 对象
真正难排查的，往往是多个小问题叠在一起：比如 .env 里密码带 # 导致配置加载失败 → 数据库连接参数为空 → Db 查询返回 false → 视图里尝试 foreach($list as $v) 时 $list 是 null → 报 Invalid argument supplied for foreach()，而你只盯着模板代码改，完全没往配置层想。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
