通过日志诊断 500 错误或空白页面
借助 Plesk 日志查找 500 错误或空白页面的原因:打开日志、读懂错误行,并修复最常见的错误消息。
本页内容
500 错误或空白页面只表明服务器端出现了问题,确切原因几乎都能在日志中找到。本指南介绍在哪里查看日志、如何理解错误行,以及如何修复最常见的情况。
准备工作
打开日志
- 登录 Plesk,打开网站与域名。
- 找到相关域名。子域名有自己的日志。
- 在开发工具中点击日志(Logs)。
- 在日志选择器中,至少保留 Apache error 和 nginx error。
如果没有此按钮,请打开文件管理器(或文件),进入 Logs 文件夹,然后点击 error_log。
| 文件 | 内容 | 用途 |
|---|---|---|
error_log |
Apache 错误,通常也包括 PHP 错误 | 首先查看此文件 |
proxy_error_log |
nginx 代理错误 | 502、504 错误和超时 |
access_log / access_ssl_log |
Apache 处理的 HTTP 和 HTTPS 请求 | 了解访问了哪些地址及其状态码 |
proxy_access_log / proxy_access_ssl_log |
nginx 处理的请求 | 用途相同,针对代理层 |
在错误发生时捕获它
- 在日志页面点击启动实时更新。
- 在另一个标签页中重新加载出错的页面。
- 返回日志,查看刚刚出现的行。
- 如果有多行,请从这一组的第一行开始看,后面的错误往往是它引起的。
如需查看或下载完整文件,请点击 Manage Log Files(管理日志文件)。
读懂错误行
文本
[Wed Nov 18 10:42:07.123456 2026] [proxy_fcgi:error] [pid 12345] [client 203.0.113.10:51234] AH01071: Got error 'PHP message: PHP Fatal error: Uncaught Error: Call to undefined function my_function() in .../httpdocs/index.php:12'| 部分 | 含义 |
|---|---|
[Wed Nov 18 10:42:07...] |
日期和时间,采用服务器时区 |
[proxy_fcgi:error] |
相关组件和严重级别 |
[client 203.0.113.10:51234] |
发起请求的访客地址 |
PHP Fatal error |
错误类型 |
Call to undefined function my_function() |
问题描述 |
.../httpdocs/index.php:12 |
需要检查的文件和行号 |
修复常见错误
| 日志消息 | 原因 | 处理方法 |
|---|---|---|
PHP Parse error: syntax error, unexpected ... |
PHP 文件存在语法错误 | 修正所示的行,或恢复该文件的上一版本 |
PHP Fatal error: Uncaught Error: Call to undefined function ... |
函数不存在:缺少 PHP 扩展、文件未加载,或代码与 PHP 版本不兼容 | 在 PHP 设置中检查版本,并更新相关插件或主题 |
PHP Fatal error: Allowed memory size of ... bytes exhausted |
达到内存限制 | 找出造成问题的插件,如果选项可用,再提高 memory_limit |
PHP Fatal error: Maximum execution time of ... seconds exceeded |
脚本运行时间过长 | 优化处理过程,如果选项可用,再调整 max_execution_time |
mod_fcgid: read data timeout |
PHP 未能及时响应 | 处理方式与执行时间超限相同 |
Request exceeded the limit of 10 internal redirects |
重写规则循环,通常位于 .htaccess |
临时重命名 .htaccess 以确认,然后修正规则 |
Invalid command '...', perhaps misspelled or defined by a module not included in the server configuration |
.htaccess 中的指令无效或不受支持 |
删除或修正所示的行 |
Option FollowSymLinks not allowed here |
服务器配置禁止在 .htaccess 中使用此选项 |
从 .htaccess 中移除后测试;如果网站需要它,请联系技术支持 |
Permission denied 或 pcfg_openfile: unable to check htaccess file |
文件或文件夹权限不正确 | 恢复标准权限,通常文件为 644,文件夹为 755 |
proxy_error_log 中的 upstream timed out |
应用服务器响应过慢(504 错误) | 找出响应缓慢的页面或任务 |
空白页面
空白页面通常是 PHP 致命错误,而生产环境关闭错误显示属于正常设置。请先查看 error_log。
如果其中没有记录,请检查以下几点:
- 问题出现前是否进行过更新、安装新插件或更改 PHP 版本?可先撤销以进行测试。
- 在 PHP 设置中,查看 phpinfo() 页面链接会显示当前生效的值,包括
log_errors和error_reporting。 - 您的应用程序是否有自己的日志?
启用 WordPress 调试日志
在 wp-config.php 中,将以下内容添加到 That's all, stop editing! 注释上方。如果某些常量已经存在,请直接修改,不要重复定义。
PHP
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
@ini_set( 'display_errors', 0 );重新加载页面,然后查看 wp-content/debug.log。要排查某个插件,可在 wp-content/plugins 中重命名其文件夹,然后再次测试。
其他错误代码
| 代码 | 主要排查方向 |
|---|---|
| 502 | PHP 或应用服务未正确响应。请查看 proxy_error_log 和 error_log |
| 503 | 网站可能已被挂起。请在网站与域名中确认其状态为“活动”(Active),否则请联系技术支持 |
| 504 | 处理时间过长。请在 proxy_error_log 中查找 upstream timed out |
检查结果
- 再次启动实时更新。
- 重新加载之前出错的页面,页面应正常显示且没有新错误。
- 测试其他页面、网站后台和表单。
- 移除调试设置和
.htaccess.bak等临时文件。
故障排除
| 现象 | 可能原因 | 处理方法 |
|---|---|---|
| 没有出现任何日志行 | 选错了域名,或错误由应用程序产生 | 检查域名和子域名,然后查找应用程序日志 |
| 时间对不上 | 日志使用服务器时区 | 使用实时模式以避免混淆 |
| 较早的错误不见了 | 日志已通过轮转归档 | 在 Manage Log Files 中查找归档文件 |
| 日志增长很快 | 某个错误在每次请求时重复出现 | 先修复第一个错误,再重新观察日志 |
| 无法根据消息得出结论 | 原因与服务器或套餐限制有关 | 联系技术支持,并提供页面地址、时间、您的 IP 地址和完整的日志行 |
延伸阅读
- 使用 FileZilla 通过加密 FTP 连接
- 日志文件,Plesk 官方文档
- Debugging in WordPress,WordPress 官方文档(英文)