ThinkPHP部署后500错误主因是错误被静默屏蔽，需先强制显示PHP原始错误、检查open_basedir限制、确认Nginx root指向public目录、修复runtime目录权限与可写性。
ThinkPHP部署后报500错误，多数不是代码写错了，而是环境配置、路径指向或权限控制没对齐——错误被静默屏蔽，导致你只能看到空白页或通用500状态码。核心思路是：先让真实错误浮出来，再逐层排查。
一、强制显示PHP原始错误
框架默认在非调试模式下会吞掉所有错误信息。必须绕过框架层，直接让PHP把致命错误打出来：
- 打开 public/index.php，在
<?php后第一行插入：
ini_set('display_errors', '1');<br>error_reporting(E_ALL);- 这两行必须放在
require __DIR__ . '/../vendor/autoload.php';之前； - 同时检查 Nginx 配置里是否启用了
fastcgi_intercept_errors on;，如有，注释掉并 reload； - 若仍不显示，执行
php -i | grep -E "display_errors|error_reporting"确认 CLI 和 FPM 下的设置是否一致。
二、检查 open_basedir 跨目录限制
LNMP 环境下最常见原因：ThinkPHP 入口在 public/，但核心文件（如 thinkphp/base.php）在上级目录，而默认的 open_basedir 只放行 $document_root/（即 public 目录），导致 require 失败，直接 Permission denied。
- 编辑 /usr/local/nginx/conf/fastcgi.conf，找到这行并注释掉：
# fastcgi_param PHP_ADMIN_VALUE "open_basedir=$document_root/:/tmp/:/proc/"; - 检查项目根目录下的 .user.ini，删掉或修改
open_basedir=行，确保包含整个项目路径，例如：open_basedir=/home/wwwroot/yourdomain.com/:/tmp/:/proc/ - 改完后执行
lnmp nginx reload或nginx -s reload。
三、确认 Nginx root 指向 public 目录
域名绑定了，但 Nginx 的 root 如果还指在项目根目录（如 /home/wwwroot/yourdomain.com），而不是 /home/wwwroot/yourdomain.com/public，会导致自动加载失败和路由解析错乱。
立即学习“PHP免费学习笔记（深入）”；
- 打开 /usr/local/nginx/conf/vhost/yourdomain.com.conf，确认
root指向的是.../public； - 检查
location ~ \.php$块中的fastcgi_param SCRIPT_FILENAME，必须是$document_root$fastcgi_script_name，不能硬编码路径； - 宝塔用户请进「站点设置 → 网站目录 → 运行目录」，从下拉菜单选择
/public，不要手动输入。
四、修复 runtime 目录权限与日志可写性
ThinkPHP 启动时需在 runtime/（及子目录如 log/、cache/）中创建和写入文件。若 Web 进程用户无权限，初始化就中断，直接返回 500 且不生成任何日志。
- 执行
ls -ld runtime runtime/log，确认属主是www（CentOS）或www-data（Ubuntu/Debian）； - 修复命令示例：
chown -R www:www runtime/（LNMP 默认）或chown -R www-data:www-data runtime/； - 确保
config/app.php中日志配置启用：'record' => true, 'level' => ['error']； - 顺手清空旧缓存：
rm -rf runtime/*，避免污染干扰。
不复杂但容易忽略。
