ThinkPHP搭建过程中为什么报错常见问题汇总教程-ThinkPHP-PHP中文网

class 'think\app' not found的主因是自动加载未启动，需确保public/index.php首行为require dir . '/../vendor/autoload.php';、web根目录指向public/、且php cli与web环境配置一致。

thinkphp搭建过程中为什么报错常见问题汇总教程

ThinkPHP搭建过程中报错，绝大多数不是代码写错了，而是环境、路径、配置或加载机制没对齐。框架本身很稳定，但对规则敏感——差一个斜杠、少个点、大小写不一致、权限不对，都会直接崩。

这是新手最常遇到的“一打开就500”问题。根本原因不是类丢了，是自动加载根本没启动。

检查 public/index.php 第一行是否为：require __DIR__ . '/../vendor/autoload.php'; —— 多一个点、少一个斜杠、写成 ./../vendor 都会失败
确认 Web 服务器根目录（root）指向的是 public/ 目录，不是项目根目录；否则相对路径解析错位
在终端进入项目根目录，执行 php think，能输出命令列表才说明 CLI 环境下 autoload 正常；若报错，运行 php --ini 查 CLI 加载的 php.ini 是否启用了 json、mbstring 等必需扩展

ThinkPHP 在非调试模式下会屏蔽所有 PHP 错误，只返回 HTTP 500。必须主动把错误“捞出来”才能诊断。

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

在 public/index.php 的 <?php 后立即加两行：

ini_set('display_errors', '1');<br>error_reporting(E_ALL);

确保 .env 中 APP_DEBUG=true 生效，且未被 config/app.php 里的硬编码覆盖（优先以 config 文件为准）
别只看 runtime/log/，还要查：
– PHP 错误日志（php -i | grep error_log）
– Nginx 的 /var/log/nginx/error.log 或 Apache 的 /var/log/apache2/error.log
– runtime/ 目录是否可写（属主需匹配 Web 进程用户，如 www-data）

这不是控制器不存在，是 URL 重写没生效，或服务器没传 PATH_INFO 给 PHP。

Apache 用户：确认项目根目录有正确 .htaccess，或宝塔后台选择“ThinkPHP”伪静态规则
Nginx 用户：server 块中必须包含这一行：
try_files $uri $uri/ /index.php?$query_string; —— 少了 $uri/ 会导致带斜杠路径（如 /admin/）直接 404
验证方法：访问 http://yourdomain.com/index.php/index 能通，说明路由本身注册成功；不通则运行 php think route:list 看目标路由是否存在、HTTP 方法是否匹配

不是文件没放对，是 ThinkPHP 拼路径的逻辑和你预期不同。

view_path 必须带 ./ 开头：config/view.php 中写 'view_path' => './app/view/'，漏掉 ./ 会变成绝对路径，Linux 下直接失败
$this->fetch('index') 实际查找的是 app/view/index.html，不是 app/view/index/index.html
模板后缀默认是 html；如果用 index.php，就得写 $this->fetch('index', 'php')
开启调试后，日志里搜 Template not exists:，它会打出框架真正尝试加载的完整绝对路径，一眼就能看出哪层错了

不是 SQL 写错了，是连接参数或主键约定没对上。

PDOException 信息就是关键：
– Connection refused → MySQL 服务没起，或端口不通
– Access denied for user → 用户名、密码、host 三者至少一个错
– Unknown database → 库名不存在或权限不足
Db::table('user')->find(123) 默认按 id = 123 查询；如果你的主键叫 uid，必须显式指定：Db::table('user')->pk('uid')->find(123)
检查 .env 文件编码是否为 UTF-8 without BOM（Windows 记事本保存极易带 BOM），否则变量读取为空，导致连接参数缺失