WordPress伪静态失效Nginx环境排查

知识分享

2026-09-15 14:00

11 阅读

WordPress伪静态失效通常表现为文章页、分类页出现404，而首页正常。
在Nginx环境下，这多半是try_files指令缺失或位置不对，或重写规则未生效、未重载。
按下面步骤排查，多数问题能在10分钟内解决。

判断失效范围，先确认不是固定链接设置问题

登录WordPress后台，进入“设置”>“固定链接”，直接点击“保存更改”一次。
若保存后文章页恢复正常，说明是规则未刷新；
若仍然404，继续下一步。

同时确认：首页能打开、后台能登录、只有文章/页面链接404。
满足这三点基本可锁定为Nginx伪静态问题，而非数据库或权限故障。

Nginx处理WordPress伪静态依赖try_files。
找到站点配置文件，宝塔面板路径为：网站 > 站点设置 > 配置文件；
命令行通常位于/www/server/panel/vhost/nginx/你的域名.conf或/etc/nginx/conf.d/你的域名.conf。

在location / { ... }块中，必须包含类似以下内容：

location / {
    try_files $uri $uri/ /index.php?$args;
}

如果没有这行，或写成了try_files $uri $uri/ =404;，伪静态就会失效。
补上后保存。

try_files把请求交给/index.php后，还需Nginx能正确执行PHP。
检查是否存在类似以下配置：

location ~ \.php$ {
    fastcgi_pass unix:/tmp/php-cgi-74.sock;  # 版本号以实际为准
    fastcgi_index index.php;
    include fastcgi.conf;
}

如果fastcgi_pass地址错误或PHP服务未启动，同样会导致伪静态页面404或502。
宝塔面板中可在“软件商店”确认PHP版本和运行状态。

配置修改后，宝塔面板点击“重载配置”或“重启”；
命令行执行：

nginx -t
systemctl reload nginx

先测试语法，nginx -t显示successful后再重载。
重载后打开一篇文章链接，应正常显示；
若仍404，用浏览器无痕模式或curl -I 你的文章链接查看HTTP状态码。

修复后依次访问：首页、文章页、分类页、标签页。
若全部正常，说明伪静态恢复。
建议再用curl -I确认返回200而非404。

如果以上步骤都无效，检查WordPress站点地址（URL）是否与Nginx server_name一致，不一致也会导致重写失效。

问：为什么首页正常，文章页却404？
首页通常直接请求index.php，不依赖重写；文章页需要Nginx把不存在的路径转给index.php处理，所以try_files缺失时只有文章页失效。

问：宝塔面板有伪静态快捷设置，还需要手动改吗？
宝塔的WordPress伪静态模板本质就是写入try_files规则，如果模板失效或未保存，手动检查配置文件更可靠。

问：修改后需要重启PHP吗？
通常不需要，重载Nginx即可。若PHP服务异常，可在宝塔软件商店重启对应PHP版本。

问：伪静态和固定链接是一回事吗？
不是。固定链接是WordPress后台的URL结构设置，伪静态是服务器把这种URL正确解析的规则，两者配合才能正常访问。