问题复盘总结（完整原因+避坑要点）

本次从PHP页面空白 → 404 一系列故障，核心是 Nginx 与 PHP-FPM 通讯不匹配、环境配置混乱，下面分原因、解决动作、长效避坑三部分整理。

一、故障根因梳理

1. 多PHP版本共存引发冲突
   服务器同时装了 PHP8.0/8.3/8.5，初期网站未锁定固定版本，且多余PHP服务干扰环境；aaPanel 多版本PHP必须单独管控，混用极易解析异常。
2. PHP-FPM 通讯地址不匹配（最核心问题）
   • PHP8.0-FPM 实际监听：/tmp/php-cgi-80.sock（Socket文件）
   • 前期Nginx配置尝试用 127.0.0.1:9000（端口）、失效的 enable-php-80.conf
   • 两者地址对不上 → Nginx无法转发PHP请求，先后出现页面空白、404 Not Found。
3. 面板默认PHP配置文件失效
   站点配置里 include enable-php-80.conf 调用的系统默认配置文件内容异常，无法正常加载PHP解析规则。
4. 附带小问题
   网站配置了自定义404页面，但根目录缺失 404.html，导致日志持续报文件不存在错误。

---

二、本次对应解决动作

1. 关停 PHP8.3/8.5 多余服务，网站锁定仅使用 PHP8.0（适配 Veno File Manager 4.5.2）。
2. 移除失效的 enable-php-80.conf 引用，手动编写PHP解析规则，将 fastcgi_pass 改为 FPM 真实监听地址：unix:/tmp/php-cgi-80.sock。
3. 校验 PHP8.0-FPM 进程正常运行，重启 Nginx 使配置生效，恢复PHP解析。
4. 安装 VFM 必需PHP扩展（curl、gd、zip、mbstring、fileinfo），统一网站目录/文件权限。
5. 补充404页面、添加VFM专属伪静态，修复日志报错并保障程序功能。

---

三、长效避坑规则（下次不再踩坑）

1. PHP版本管理

• 生产环境不要同时安装多个大版本PHP，按需安装即可；老旧程序（如VFM4.5.2）优先选用 PHP7.4~8.1，高版本PHP存在兼容风险。
• 网站设置里强制绑定对应PHP版本，不要留空/选择静态模式。

2. Nginx + PHP-FPM 通讯必查（重中之重）

1. 先查PHP-FPM监听方式：

   grep listen /www/server/php/版本号/etc/php-fpm.conf

   grep listen /www/server/php/版本号/etc/php-fpm.conf

   区分是 Socket文件 还是 9000端口。

2. Nginx 中 fastcgi_pass 必须和上面查询结果完全一致：
   • Socket 格式：fastcgi_pass unix:/路径/xxx.sock;
   • 端口格式：fastcgi_pass 127.0.0.1:9000;
3. 面板自动生成的 enable-php-xx.conf 失效时，直接手写PHP解析规则，不要依赖默认引用。

3. 排障通用顺序（PHP空白/404标准流程）

1. 访问纯静态HTML，判断域名/根目录是否正常；
2. 查看PHP-FPM进程是否启动：/etc/init.d/php-fpm-xx status；
3. 核对Nginx解析规则与FPM监听地址；
4. 检查文件是否存在、目录权限是否为 755、文件权限 644；
5. 查看Nginx/PHP日志定位详细报错。

4. 程序前置检查（部署PHP源码程序）

• 部署前确认程序官方兼容的PHP版本；
• 提前安装程序要求的PHP扩展；
• 大型PHP程序按需配置专属伪静态规则。

5. 细节优化

• 配置了error_page 404 就务必在网站根目录放置对应页面，避免日志冗余报错；
• 每次修改Nginx配置后，先执行 nginx -t 校验语法，再重启服务。