Class not found 错误是PSR-4自动加载失败所致，需严格校验路径、命名空间、composer.json配置及环境四者一致性，差一个大小写或斜杠即触发报错。
ThinkPHP 社区里高频出现的问题，往往不是语法写错，而是框架“按规则找东西”时路标对不上——路径、命名空间、配置、环境四者只要有一处不一致，就会触发看似奇怪的报错。下面整理几个最常被问、最容易卡住人的典型问题及直击要害的解法。
Class not found？先查这四点
这不是类文件丢了，是 PSR-4 自动加载失败的明确信号。ThinkPHP 6+ 要求 namespace 与磁盘路径严格一一对应，大小写、斜杠、目录层级差一点就崩。
- 检查控制器文件如 app/controller/Index.php 的命名空间是否为 namespace appcontroller;（注意反斜杠、无多余空格、无末尾斜杠）
- Linux 下 Index.php 和 index.php 是两个文件；Windows 开发正常，部署到 Linux 就报错
- 确认 composer.json 中
"autoload": {"psr-4": {"app\": "app/"}}没被删改或写成"app": "app/"（少一个反斜杠） - 改完立刻执行 composer dump-autoload -o 刷新映射，仅清缓存无效
Db::table()->find() 返回 null，但数据明明存在
不是 SQL 写错了，是主键字段名不匹配。ThinkPHP 默认把 find(123) 解析为 WHERE id = 123。你的表若主键叫 uid 或 user_id，就必然查不到。
- 临时方案：
Db::name('user')->pk('uid')->find(123) - 长期方案：建 UserModel，并在类中声明
protected $pk = 'uid'; - 注意：
Db::table()不读模型配置，pk()必须显式调用 - 开启
log.sql = true查看真实执行语句，比猜快得多
模板 fetch() 报“文件不存在”，但文件确实在
ThinkPHP 默认按 模块/控制器/操作 拼路径，不是你传什么它就找什么。静默失败通常因路径拼错、大小写不一致或后缀没配对。
立即学习“PHP免费学习笔记（深入）”；
-
$this->fetch('index')→ 实际找的是 view/index.html，不是view/index/index.html -
config/view.php 中
'view_path' => './app/view/'必须带开头的./，漏掉会变成绝对路径 -
view_suffix默认是'html'，模板叫 index.php 就得写$this->fetch('index', 'php')
缓存文件引发 unserialize() 报错
常见于 ThinkPHP5 文件缓存驱动，错误提示类似 unserialize(): Error at offset 0 of 4 bytes。本质是缓存文件内容损坏，导致反序列化失败。
- 最常见原因：服务器异常断电、强制重启，或高并发下缓存写入未完成就被中断
- 临时处理：清空 runtime/cache/ 目录（不要只删部分文件）
- 进阶防护：切换为 Redis 缓存驱动，避免文件 IO 风险
- 生产环境建议：在部署脚本中加入缓存清理步骤，并监控磁盘空间与 IO 状态
