PHP 8.4 下 WordPress 伪静态失效需五步修复：一、重选宝塔内置 WordPress 伪静态模板并重载；二、将 if+rewrite 替换为 try_files 指令；三、修正 enable-php-84.conf 中 PATH_INFO 传递变量为 $fastcgi_path_info；四、清除浏览器、CDN 及 OPcache 缓存；五、确保 fastcgi_param 中 QUERY_STRING 使用 $query_string 完整传递。
如果您在 宝塔面板 中升级或切换至 PHP 8.4 后发现 WordPress 或其他 PHP 程序的伪静态规则失效，表现为页面 404、固定链接跳转失败、首页无法加载或 URL 中出现 /index.php等异常路径，则很可能是 Nginx 重写逻辑与 PHP 8.4 运行时环境协同异常所致。以下是修复 PHP 8.4 环境下伪静态失效的具体操作步骤：
一、确认并重载标准 WordPress 伪静态模板
宝塔面板内置的 WordPress 伪静态规则已适配主流 PHP 版本，但手动修改或旧规则残留可能导致与 PHP 8.4 的 fastcgi_params 传递不兼容。优先使用官方模板可规避语法歧义与路径解析偏差。
1、登录宝塔面板，进入【网站】列表，点击目标站点右侧的【设置】按钮。
2、在设置弹窗中选择【伪静态】选项卡。
立即学习“PHP 免费学习笔记（深入）”；
3、从下拉菜单中选择 WordPress 模板，而非“自定义”或空值。
4、点击【保存】按钮，系统将自动写入标准 Nginx 规则并触发 Nginx 重载。
5、打开终端（SSH），执行 nginx -t 验证配置语法正确性，再执行 service nginx reload 确保生效。
二、手动修正 Nginx location 块中的 try_files 指令
PHP 8.4 对 PATH_INFO 和 QUERY_STRING 的解析更严格，原 if+rewrite 组合易被 Nginx 1.22+ 版本标记为过时且引发重写循环。改用 try_files 可提升兼容性与性能稳定性。
1、在【网站】→【设置】→【配置文件】中定位到 server 块内 location / 段落。
2、将原有 if 判断块（含 rewrite 语句）整体替换为以下标准写法：
location / {try_files $uri $uri/ /index.php?$args;}
3、若存在 wp-admin 重定向需求，追加独立规则：
rewrite ^/wp-admin$ $scheme://$host$uri/ permanent;
4、保存配置文件，返回终端执行nginx -t && service nginx reload。
三、启用并校准 pathinfo 支持（针对 ThinkPHP/Laravel 等框架）
PHP 8.4 默认禁用 PATH_INFO 传递，而部分框架依赖 $_SERVER[‘PATH_INFO’]解析路由。需同步调整 Nginx fastcgi_param 配置以匹配新版 PHP 行为。
1、在宝塔面板中进入【软件商店】→【已安装】→找到当前使用的 Nginx 版本→点击【设置】→【配置修改】。
2、搜索 enable-php.conf 或直接编辑该文件路径：/www/server/nginx/conf/enable-php-84.conf。
3、确保以下两行未被注释且参数准确：
include pathinfo.conf;
fastcgi_param PATH_INFO $fastcgi_path_info;
4、若原配置中为 $request_uri 或$path_info，须更正为$fastcgi_path_info——这是 PHP 8.4 FPM 模块要求的标准变量名。
5、保存后执行service nginx reload。
四、检查并清除多层缓存干扰
伪静态失效常被误判为规则错误，实则由浏览器、CDN 或 OPcache 缓存导致旧重定向逻辑持续生效。PHP 8.4 启用 OPcache 后，默认缓存时间延长，需主动刷新。
1、在浏览器中使用无痕窗口访问网站首页及任意固定链接 URL，排除本地缓存影响。
2、登录宝塔面板，进入【软件商店】→【PHP 管理】→对应 PHP 8.4 版本→【配置修改】→搜索 opcache.enable，临时设为0 并重启 PHP 服务。
3、若启用 CDN（如 Cloudflare、百度云加速），在 CDN 控制台执行 缓存清理 → 全站刷新。
4、检查网站根目录是否存在。htaccess 文件，若有且非 Apache 环境，应 立即删除或重命名，避免 Nginx 误读干扰。
五、验证 fastcgi_param QUERY_STRING 传递完整性
PHP 8.4 强化了查询参数安全性校验，若 Nginx 未显式传递 $arg 或 $query_string，会导致 $_GET 为空、WP_Query 初始化失败，进而触发伪静态降级为 /index.php?q= 形式。
1、打开网站配置文件（/www/server/panel/vhost/nginx/ 域名。conf），定位 fastcgi_params 区块。
2、确认包含以下关键行（缺失则手动添加）：
fastcgi_param QUERY_STRING $query_string;
fastcgi_param REQUEST_URI $request_uri;
fastcgi_param SCRIPT_NAME $fastcgi_script_name;
3、检查是否误写为 $args（仅含键值对，不含原始字符串），应统一使用$query_string 保证完整传递。
4、保存配置，执行nginx -t && service nginx reload。
