class not found 错误主因是命名空间或目录结构不匹配，需严格遵循psr-4规范，检查大小写、namespace声明、类名与文件名一致，并执行composer dump-autoload -o刷新自动加载。
ThinkPHP 6 报错 Class not found 怎么快速定位
不是自动加载没配好，大概率是命名空间或目录结构不匹配。ThinkPHP 6 严格依赖 PSR-4 规范，app\controller\Index 必须对应 app/controller/Index.php 文件，且类名必须是 Index，不能写成 index 或 IndexController。
常见错误现象：
- 浏览器显示
Class "app\controller\Index" not found，但文件明明存在 - 命令行执行
php think run正常，但浏览器访问报错 - 从 TP5 升级过来后大量控制器报这个错
实操建议：
- 检查文件路径大小写：Linux 下
Index.php和index.php是不同文件，Windows 不敏感但部署到服务器会出问题 - 确认类定义顶部有
namespace app\controller;，且class Index没加Controller后缀（TP6 默认去掉后缀，除非你改了路由配置） - 运行
composer dump-autoload -o强制刷新自动加载映射，别只靠清缓存
调试模式开启但 Whoops 不显示错误详情
ThinkPHP 6 默认用 Whoops 渲染错误页面，但经常只显示白屏或“500 Error”，实际是异常被中间件吞掉了，或者环境配置没生效。
关键点在于：APP_DEBUG 必须为 true，且不能被运行时配置覆盖；同时 whoops 扩展需已安装，且未被禁用。
实操建议：
- 在
.env文件里明确写APP_DEBUG=true，不要只靠config/app.php里的'debug' => true - 检查
config/exception.php中的'ignore_exception' => []是否误加了你正在抛出的异常类 - 如果用了 Swoole 或 RoadRunner，
Whoops默认不生效，得手动在app/exception/Handler.php的render方法里返回response()->view(...)或接入其他调试器
Db::table('user')->where('id', 1)->find() 返回 null，但数据明明存在
不是 SQL 写错了，而是默认主键被识别成了 id，但你的表主键其实是 uid 或复合主键 —— ThinkPHP 6 的查询构造器会自动把 find() 解析成 SELECT * FROM user WHERE id = 1 LIMIT 1，如果主键不是 id，就查不到。
使用场景：老项目迁移、自定义主键、无主键表、分表场景
实操建议：
- 在模型中显式指定主键：
protected $pk = 'uid';，或临时用Db::name('user')->pk('uid')->where('uid', 1)->find() - 避免直接用
table()查无模型关联的表，优先建模型并设置$table和$pk - 开启 SQL 日志（
log.sql = true）看实际执行语句，比猜快得多
修改了 config/route.php 但新路由不生效
ThinkPHP 6 路由缓存强，默认开启，改完路由文件不清理缓存等于没改。而且路由注册顺序、闭包路由和注解路由混用时，容易因优先级导致规则被忽略。
性能影响：关闭路由缓存（route_check => false）会明显拖慢响应，尤其在高并发下
实操建议：
- 开发阶段务必执行
php think route:clear，而不是只删runtime/route目录 - 检查是否在
app/middleware.php里提前终止了请求（比如某个中间件return了 Response，后面路由根本没机会匹配） - 注解路由（
@Route）需要额外启用think-annotation扩展，并在config/app.php中开启'annotation' => true
最常被忽略的是：路由规则写了，但控制器方法没加 public 修饰符，或者参数类型声明（如 int $id）和实际传入不一致，导致匹配失败却不报错。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
