ThinkPHP新手常见问题怎么解决_ThinkPHP入门难题故障排查指南【操作】-ThinkPHP-PHP中文网

类找不到、模板不渲染、路由404、数据库连不上，本质是thinkphp按规则自动加载/解析时路径、命名空间、配置或环境不匹配：psr-4要求namespace与目录严格一致；view_path需带./；url重写需服务器支持；database.php的prefix、debug、认证插件须匹配环境。

thinkphp新手常见问题怎么解决_thinkphp入门难题故障排查指南【操作】

类找不到、模板不渲染、路由 404、数据库连不上——这些不是你代码写错了，而是 ThinkPHP 在“按规则找东西”，而你没给它对的路标。

这个错误几乎占新手报错的 70%，根本原因不是文件丢了，而是框架在 PSR-4 自动加载下“认不出你是谁”。ThinkPHP6 要求 namespace 和磁盘路径严格一致，差一个字母大小写、多一层目录、少一个反斜杠，都会失败。

app/controller/Index.php 的命名空间必须是 namespace appcontroller;，不能是 AppController 或 app/controller/（末尾斜杠）
Linux 服务器上，Index.php 和 index.php 是两个文件；Windows 开发时没问题，一上线就报错
用 composer dump-autoload -o 刷新自动加载映射，尤其改过命名空间或移动过文件后
检查 composer.json 中的 "autoload": {"psr-4": {...}} 是否仍指向 "app\" : "app/"

不是文件真没了，而是 $this->fetch() 默认拼接路径的逻辑和你预期不一致。ThinkPHP6 不再默认读 app/view/，而是按 config/view.php 配置的 view_path 和 view_suffix 去找。

确认 config/view.php 中 'view_path' => './app/view/'（注意开头的 ./，漏掉会变成绝对路径）
view_suffix 默认是 'html'，但如果你的模板叫 index.php，就得显式写 $this->fetch('index', 'php')
控制器里调用 $this->fetch('admin/index')，实际查找的是 app/view/admin/index.html，不是 app/view/index/admin.html
刚装完 topthink/think-view 却没生效？检查 config/app.php 的 'default_return_type' => 'html' 和中间件是否启用视图支持

说明路由规则被定义了，但没被匹配到——常见于入口配置、URL 模式、或伪静态未开启。

Apache 环境必须启用 mod_rewrite，且项目根目录有正确 .htaccess；Nginx 需在 server 块中添加 try_files $uri $uri/ /index.php?$query_string;
访问 /index.php/index/index 能通，但直接访问 /index/index 404？说明 URL 重写没生效
命令行执行 php think route:list，确认目标路由确实在列表里，且 HTTP 方法（GET/POST）匹配
自定义路由写在 route/app.php 还是 route/route.php？TP6 默认只加载 route/app.php，route.php 已废弃

不是查不到，是连接、前缀、字段或编码把查询拦在了半路。尤其当本地能跑、线上挂掉时，90% 是环境差异导致的静默失败。

打开 config/database.php 的 'debug' => true，看日志里有没有真实执行的 SQL；没有 SQL 日志，说明连数据库都没连上
检查 'prefix' 配置：表名是 tp_user，但配置了 'prefix' => 'think_'，那 Db::table('user') 实际查的是 think_user，自然为空
MySQL 8+ 默认认证插件是 caching_sha2_password，PHP 7.4 以下可能不兼容，需改用 mysql_native_password
Db::getLastSql() 放在查询后立刻调用，能拿到最终拼出的 SQL，复制到 Navicat 里一试便知是不是语句本身有问题