PHP 8.5.5 部署 Nginx 必须精准匹配 fastcgi_pass 路径、php-fpm 服务名（如 php8.5-fpm）和 SCRIPT_FILENAME 拼接逻辑，三者任一错即导致 502 或空白页；需用 ls 或 systemctl 确认 socket 实际路径，显式设置 fastcgi_param SCRIPT_FILENAME，并调优 OPcache 与 realpath_cache。
PHP 8.5.5 能直接用在 Nginx 上，但默认配置不等于生产可用——关键在于 fastcgi_pass 路径、php-fpm 服务名、以及 SCRIPT_FILENAME 的拼接逻辑是否匹配。错一个字符，就可能返回空白页或 502。
确认 PHP-FPM 服务名和 socket 路径是否真实存在
PHP 8.5.5 安装后，FPM 服务名不再是 php8.1-fpm 或 php8.2-fpm，而是按实际版本命名，常见为 php8.5-fpm（Ubuntu/Debian）或 php-fpm（CentOS/RHEL + Remi 仓库）。socket 文件路径也随版本变化：
- Ubuntu/Debian 默认 socket：
/run/php/php8.5-fpm.sock（注意不是/var/run/php/） - CentOS/RHEL + Remi 默认 socket：
/run/php-fpm/www.sock或/var/run/php-fpm/php-fpm.sock，取决于 pool 配置 - 必须用
ls -l /run/php/或sudo systemctl status php8.5-fpm查看实际监听地址，不能凭经验硬写 -
fastcgi_pass必须与php-fpm的listen指令完全一致，否则 502 是唯一结果
location ~ \.php$ 块里必须显式设置 SCRIPT_FILENAME
新版 Nginx（1.20+）和 PHP 8.5 默认禁用 PATH_INFO 自动推导，且 snippets/fastcgi-php.conf 不再自动补全 SCRIPT_FILENAME。漏掉这行，PHP 脚本根本不会执行，浏览器只显示空白或下载源码：
- 务必保留：
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; - 不要依赖
include snippets/fastcgi-php.conf里的旧逻辑——它在某些发行版中已移除该参数 - 如果用了
alias而非root，$document_root会为空，此时必须手写绝对路径，例如：fastcgi_param SCRIPT_FILENAME /var/www/myapp/public$fastcgi_script_name;
PHP 8.5.5 的 OPcache 和 realpath_cache 需主动调优
PHP 8.5 强化了符号表缓存和 realpath 查询优化，但默认值对高并发站点仍偏保守。不调，小流量没事，一上量就卡在文件查找上：
立即学习“PHP免费学习笔记（深入）”；
- 编辑
/etc/php/8.5/fpm/php.ini，确认以下项已启用并调大： -
opcache.enable=1（必须开） -
opcache.memory_consumption=256（建议 ≥128，视应用大小定） -
realpath_cache_size=4M（默认 4K，太小；大量 symlink 或 vendor 目录时必调） -
realpath_cache_ttl=600（默认 120 秒，可适当延长减少 stat 系统调用） - 改完后必须
sudo systemctl restart php8.5-fpm，仅 reload 不生效
检查日志时优先看这两处输出
遇到 502、空白页或 403，别急着重配，先盯住两个最直接的日志源：
- Nginx 错误日志：
/var/log/nginx/error.log，搜connect() failed（socket 路径错）、Permission denied（权限或 SELinux）、upstream prematurely closed（PHP 进程崩溃） - PHP-FPM 日志：
/var/log/php8.5-fpm.log或journalctl -u php8.5-fpm -f，看是否有unable to bind listening socket（端口被占）、failed to open stream（open_basedir 拦截）、或 segfault 记录 - 特别注意：PHP 8.5.5 默认关闭
display_errors，开发时需手动设为On并配合error_log = /var/log/php-error.log才能看到致命错误
PHP 8.5.5 的兼容性改动很克制，但 socket 路径、FPM 服务名、SCRIPT_FILENAME 绑定这三处，是部署时最容易“以为对了其实错了”的地方。调完别忘用 curl -I http://localhost/info.php 验证响应头，比打开浏览器更快定位问题。
