Debian 下 LNMP 调试流程与要点
一、快速定位流程
二、Nginx 与 PHP-FPM 专项排查
三、MariaDB MySQL 专项排查
四、日志管理与高级调试
五、常见症状与处理对照表
| 症状 | 优先检查 | 快速修复 |
|---|---|---|
| 502 Bad Gateway | Nginx error.log、PHP-FPM 是否运行、listen 地址与权限(/var/run/php/ 目录、socket 所属用户组) | 确认 php-fpm 运行;统一 fastcgi_pass 与 FPM 的 listen;必要时将 www-data 加入 FPM 运行用户组并重启服务 |
| 403 Forbidden | Nginx 配置 root 与 index、目录权限(/var/www/html 及子目录对 www-data 可读) | 修正 root 路径与 index 指令;设置目录权限为 755、文件 644 |
| 404 Not Found | Nginx location 匹配、root 指向、文件是否存在 | 校正 root 与 try_files;确认文件已部署到指定目录 |
| 数据库连接失败 | 应用 DB 配置、MySQL 是否运行、/var/log/mysql/error.log、端口与防火墙 | 启动 mysql;核对 host/user/password;开放 3306 或改用 127.0.0.1;检查云安全组 |
| PHP 空白页 | PHP 错误日志、display_errors、short_open_tag、语法错误 | 开启并记录 PHP 错误日志;临时打开 display_errors 定位;修正语法或启用 short_open_tag |
| 上传/写入失败 | 目录权限、PHP upload_max_filesize/post_max_size、磁盘空间 | 为上传目录赋权 www-data;在 php.ini 调整上传大小限制;清理磁盘空间 |