ThinkPHP 运行出现 500 错误时，日志默认存储在项目根目录的 runtime/log/ 文件夹下，若该目录无记录，需进一步检查 PHP 错误日志及 Nginx/Apache/Web 服务器日志。

命令速用版

以下命令用于快速定位日志文件和验证环境配置，直接在服务器终端执行：

\n# 查看 PHP 错误日志配置路径\nphp -i | grep error_log\n\n# 实时跟踪 ThinkPHP 运行时日志\ntail -f runtime/log/$(date +%Y%m%d).log\n\n# 实时跟踪 Nginx 错误日志\nsudo tail -f /var/log/nginx/error.log\n\n# 检查 runtime 目录权限\nls -ld runtime/ runtime/log/\n

为什么会这样

ThinkPHP 报 500 错误却看不到任何提示，本质是错误被框架或 PHP 层级静默吞掉。

框架在生产环境默认 APP_DEBUG=false，会屏蔽所有 PHP 错误和异常，只返回 HTTP 500 状态码。同时，若 PHP 配置的 display_errors 为 Off 或 error_reporting 级别不足，底层致命错误也不会输出到页面或日志，导致排查像在黑盒里摸开关。日志分散于 PHP、Web 服务器及框架三层，须逐层确认真实落盘位置。

分步处理

按以下顺序排查，确保每一步都有明确的操作和检查点：

1. 检查 ThinkPHP 框架日志
确认项目根目录下 runtime/log/ 文件夹是否存在。打开 config/app.php 或配置文件，确保 log 配置项中'record' => true 显式存在。若目录不存在或不可写，框架无法生成日志。

2. 强制暴露 PHP 错误信息
打开 public/index.php 文件，在第一行ini_set('display_errors', '1');
error_reporting(E_ALL);
保存后刷新页面，若出现红色错误堆栈，说明问题出在 PHP 代码层。

3. 查看 PHP 错误日志
运行 php -i | grep error_log 确认日志路径。检查该路径文件是否存在且可写，若无权限则运行 chown 命令修正属主。刷新页面后查看日志末尾是否有新错误行。

4. 检查 Web 服务器日志
若 PHP 日志为空，检查 Nginx 或 Apache 错误日志。Nginx 默认路径为/var/log/nginx/error.log，Apache 为/var/log/apache2/error.log。筛选关键词如"PHP Fatal"或"upstream timed out"定位网关层问题。

怎么验证是否生效

执行完配置修改后，通过以下现象确认排查环境已就绪：

1. 刷新报错页面，若能看到具体的红色错误堆栈或 Warning 信息，说明 display_errors 已生效。
2. 运行 tail -f 命令监控日志文件，刷新页面时终端有新增日志行，说明日志写入权限正常。
3. 若之前 runtime/log/ 为空，现在生成了以日期命名的.log 文件，说明 LOG_RECORD 配置已生效。

常见坑

排查过程中容易忽略以下细节，导致问题无法复现或日志依旧为空：

1. 目录权限不对：storage/ 和 runtime/ 必须可写，重点不是 chmod 777，而是属主匹配 Web 进程用户，如 www-data 或 nginx。
2. 配置被覆盖：.env 的 APP_DEBUG=true 可能被 config/app.php 里的硬编码覆盖，优先以 config 文件为准。
3. 中文路径问题：Windows 下项目路径含中文或服务器名是中文，可能触发 Malformed UTF-8 characters 错误，该错误在 JSON 编码阶段就被静默捕获。
4. 日志开关关闭：LOG_RECORD 默认为 false，必须显式设为 true 才会记录异常堆栈，仅靠 LOG_LEVEL 配置无效。

常见问题

runtime/log/ 里没日志是不是没出错？

日志为空不代表没出错，大概率是 LOG_RECORD 关着、runtime/ 不可写，或 PHP 根本没走到日志写入那步。

APP_DEBUG=true 却还是 500 页面怎么办？

框架检测到 PHP 环境不满足调试前提时会主动抛出 500，必须同时满足 display_errors = On、error_reporting≥E_ALL、log_errors = On。

IIS 环境下在哪里查看错误详情？

IIS 需启用详细错误信息，在 IIS 管理器中将“错误页”响应状态代码设为“详细错误”，并校验 web.config 中 httperrors 节点配置。

参考来源

• ThinkPHP500 错误怎么排查_日志文件定位与 Debug 追踪【详解】
• 新手搭建 ThinkPHP 项目报错 500?常见故障排查与日志分析【解答】
• ThinkPHP 如何查看 Nginx 错误日志_Nginx 错误日志分析技巧【排查】
• ThinkPHP 新手入门避坑:500 错误不显示？开启 display_errors 调试指南【解答】
• IIS 下 ThinkPHP 报 500 错误，如何查看详细错误信息？