写给愿意动手的 PHP 开发者
PHP学习网 PHP学习网
公告PHP学习网为公益性网站,致力于为广大PHP爱好者服务
首页/ phpstudy 专区/ phpstudy 常见报错排查手册
排错 通用 PHP 全版本

phpstudy 常见报错排查手册

启动失败、403、404、500、白屏、503、端口占用、SSL 握手失败,按现象给排查顺序,不靠猜。

排查的原则是「从外到内」:先确认服务在不在,再看端口和网络,再看服务器配置,最后看 PHP 和代码。跳过前面几步直接改代码,往往白忙。

服务启动失败

面板显示「已启动」但实际没起来,去任务管理器看进程。常见原因:端口被占用、安装路径含中文、杀毒软件拦截、vhost 配置语法错误。

Nginx 起不来时,先在命令行执行 nginx -t,它会直接告诉你第几行配置有问题。

403 Forbidden

三个原因:目录下没有默认首页文件、目录权限不足、Nginx 的 autoindex 关闭且没有 index。

Windows 下还要看目录是否被设置为只读,或者当前用户没有读取权限。Linux 下看目录的执行位(x),没有 x 位连进入都不行。

404 Not Found

先分清是谁返回的 404:Nginx 默认页面(说明请求没到 PHP)还是你的程序页面(说明路由没匹配)。

请求没到 PHP:站点根目录指错、伪静态没生效、location 规则拦截。路由没匹配:看 URL 是否多了或少了斜杠、路由表是否区分大小写。

500 Internal Server Error

先看 PHP 错误日志(phpstudy 面板可以直接打开)。常见原因:语法错误、扩展缺失、权限不足、内存超限、OPcache 缓存了旧代码。

命令行执行 php -l 文件名 可以快速定位语法错误。改了代码但页面没变,重启 PHP 服务清 OPcache。

白屏没有任何输出

display_errors 被关掉了。临时在入口加两行:

PHP
ini_set('display_errors', '1');
error_reporting(E_ALL);

如果还是白屏,看 PHP 错误日志,或者用命令行 php index.php 直接跑,错误会打到终端。

502 / 503

502 是网关收到了无效响应,通常是 PHP-FPM 挂了或超时;503 是服务不可用,可能是队列满了或维护模式。

看 PHP-FPM 的错误日志和 slowlog,确认是进程崩溃还是执行太慢。

记住一条:任何「打不开」的问题,先 curl -I 看响应头和状态码,比在浏览器里刷新十次有用。

继续看