ThinkPHP5部署到Linux服务器报500错误怎么排查-ThinkPHP-PHP中文网

php 500 错误主因是错误被静默拦截，需开启错误显示、检查 fastcgi_intercept_errors、排查 error.log；runtime 权限不足、open_basedir 跨目录限制、path_info 伪静态配置缺失是三大常见根源。

thinkphp5部署到linux服务器报500错误怎么排查

看 PHP 错误日志，别猜

500 不是“服务器炸了”，而是 PHP 执行中途被拦下了。LNMP 环境下默认不显示错误，直接返回空白或 500。先打开错误输出：

在 public/index.php 顶部紧贴 <?php 加两行：error_reporting(E_ALL); ini_set('display_errors', '1');
确认 Nginx 的 fastcgi 配置没吞错误：检查 /usr/local/nginx/conf/fastcgi.conf 是否含 fastcgi_intercept_errors on;，有就改成 off 或删掉
查真实错误源：tail -f /home/wwwlogs/yourdomain.com_error.log（路径以你实际 error_log 指令为准）

常见日志线索：PHP Fatal error: Uncaught exception 'think\exception\ErrorException' with message 'mkdir(): Permission denied' → 权限问题；open_basedir restriction in effect → 跨目录限制。

runtime 目录权限不对是最常见原因

TP5 运行时要写日志、缓存、模板编译文件，默认生成在 runtime/ 下。Linux 下 Web 进程（如 www 用户）没权限写入就会报 500，但页面可能看起来“内容正常”——因为错误发生在响应头之后。

linux-performance-analyzer

Linux 性能分析与调优专家，覆盖 CPU、内存、磁盘 I/O、网络、内核参数、编译优化、容器/K8s。适用场景：系统卡顿/高负载、内存不足/OOM/Swap 高、CPU 异常/iowait 高。

下载

确保 runtime/ 在项目根目录（不是 public/runtime），且路径正确
执行：chmod -R 755 runtime（开发环境可临时 777，上线必须收窄）
检查属主：chown -R www:www runtime（LNMP 默认用 www 用户跑 PHP-FPM）
注意：改完必须清空 runtime/ 里所有子目录和隐藏文件，否则旧缓存会掩盖新权限生效

LNMP 的 open_basedir 限制导致跨目录加载失败

TP5 入口在 public/index.php，但它要 require ../thinkphp/base.php。LNMP 默认把 open_basedir 锁死在 $document_root/（即 public 目录），一跨上级就拒之门外，报错信息里必带 open_basedir restriction。

优先用官方脚本：lnmp1.5/tools/remove_open_basedir_restriction.sh（版本对得上才有效）
手动改法（不推荐全局放开）：/usr/local/nginx/conf/fastcgi.conf 中注释掉这行：fastcgi_param PHP_ADMIN_VALUE "open_basedir=$document_root/:/tmp/:/proc/";
更安全的改法：在对应站点的 Nginx 配置里（如 /usr/local/nginx/conf/vhost/yourdomain.com.conf）的 location ~ \.php 块内，加一行：fastcgi_param PHP_ADMIN_VALUE "open_basedir=/home/wwwroot/yourdomain.com/:/tmp/:/proc/";，然后 lnmp nginx restart

伪静态和 PATH_INFO 配置缺失引发 404/500 混合错误

Nginx 默认不支持 ThinkPHP 的 PATH_INFO 路由模式，index.php/a/b 这类 URL 会被当成文件路径找，找不到就 404；某些配置错位还会触发 500。不是所有 TP5 部署都依赖 PATH_INFO，但一旦开启路由或使用兼容模式，就必须配对。

确认入口已设为 public/ 目录，Nginx root 指向正确（不是项目根目录）
站点配置中 location ~ \.php 块必须包含 fastcgi_param PATH_INFO $path_info; 和正确拆分逻辑，参考 LNMP 官方 TP5 补丁配置
如果用的是 url_model = 2（PATH_INFO），但 Nginx 没传 PATH_INFO，框架会尝试解析 $_SERVER['REQUEST_URI'] 失败，也可能静默 500

真正卡住的地方往往不在框架本身，而在 Nginx 和 PHP-FPM 之间那几行 fastcgi_param 的传递是否完整、open_basedir 是否精准覆盖到你的项目结构层级、以及 runtime 是否真的被 web 用户拥有写权限——这三个点漏一个，500 就稳稳等着你。