thinkphp部署报错多数因路径、命名空间、配置或环境四者之一偏差所致，核心是自动加载失败或web根目录未指向public/，需验证autoload引入、opcache启用、大小写敏感、重写规则及runtime可写性。
ThinkPHP部署报错，多数不是代码写错了，而是框架在“按规则找东西”时没对上路标——路径、命名空间、配置、环境四者只要有一处偏差，就会触发看似离谱的错误。绝大多数问题靠看清楚错误信息 + 验证基础前提就能解决，不用猜、不用重装。
Class 'think\App' not found 或类找不到
这是自动加载失败的典型表现，本质是 PHP 没加载到 vendor/autoload.php。
- 检查 public/index.php 第12行左右是否为：
require __DIR__ . '/../vendor/autoload.php';—— 不能是硬编码的本地绝对路径（如/Users/xxx/project/vendor/autoload.php） - 确认 vendor/ 目录已上传，且 vendor/autoload.php 文件存在、可读
- 运行
php -i | grep opcache，确保 opcache.enable = On 且 opcache.enable_cli = 1（CLI 模式必须开，否则php think命令生成的缓存不生效） - Linux 下注意大小写：
Index.php和index.php是两个文件；Windows 开发没问题，部署后立刻报错
访问直接 404 或路由不生效
根本原因是 Nginx/Apache 没把请求交给 public/index.php 处理，ThinkPHP 的路由根本没机会运行。
- 确认 Web 根目录指向的是 public/，不是项目根目录（例如应为
/var/www/html/myapp/public/，而非/var/www/html/myapp/） - Apache：开启
mod_rewrite，虚拟主机配置中设AllowOverride All（不能是None），确保.htaccess生效 - Nginx：在
server块内添加标准规则（注意末尾斜杠和 PATH_INFO 传递）：
if (!-e $request_filename) {
rewrite ^(.*)$ /index.php?s=$1 last;
}
}
- 二级目录部署（如
/myapp/）必须显式写location /myapp/ { ... }，并配好alias和fastcgi_param PATH_INFO $fastcgi_path_info;
数据库操作返回 null 或连接失败
不是 SQL 写错了，是主键或连接参数没对上。
-
Db::table('user')->find(123)默认查WHERE id = 123；若表主键是uid，必须显式声明：Db::name('user')->pk('uid')->find(123) - PDO 异常 message 是关键线索：
•Connection refused→ MySQL 服务未启动或端口不通
•Access denied for user→ 用户名、密码、host 至少一个不匹配
•Unknown database→ 数据库名不存在或权限不足 - 检查
.env文件是否 UTF-8 无 BOM 编码，是否放在项目根目录，且未被权限或自定义入口绕过加载
关闭调试后白屏、无日志
APP_DEBUG = false 后，ThinkPHP 不显示错误，也不写日志——除非 runtime/log/ 可写。
- 临时把
config/app.php中APP_DEBUG改为true，看真实报错 - 确认 runtime/ 目录存在、属于 Web 用户（如
www-data或nginx），权限设为755或775 - 若用宝塔等面板，检查“防跨站”是否限制了
runtime/写入，需手动加白名单或关闭 - 不要上传本地已有的
runtime/cache/或runtime/log/，清空再传
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
