现象
Z-BlogPHP 1.7 在后台开启伪静态,把面板给出的 Nginx 规则贴进站点配置,reload 之后首页能打开,点进任何文章页都是 404,分类页和标签页同样打不开。关掉伪静态换成 index.php?post=1 这种地址又完全正常。
原因
规则没有被真正加载是最常见的情况:宝塔站点配置里 include 的路径写错,或者规则贴到了 server 块外面;location / 里先写了 try_files,请求被交给不存在的文件;站点跑在子目录时,规则里的 /index.php 少了目录前缀;Apache 环境则是 AllowOverride None,让 .htaccess 完全失效。
解决步骤
第一步,确认规则究竟有没有生效。用 nginx -T 打印合并后的配置,搜索 rewrite 与 include,看规则是否在域名对应的 server 块内,再用 curl 看返回码。
nginx -T | grep -n -E "server_name|rewrite|include"
curl -I https://www.example.com/post/1.html
tail -n 30 /www/wwwlogs/nginx_error.log
第二步,改成统一的入口写法。在 location / 里先 try_files $uri $uri/ /index.php?$query_string,再配合官方规则,避免多条 rewrite 互相覆盖;子目录部署时入口要带目录前缀。
第三步,清缓存并重新保存设置。Z-BlogPHP 会把伪静态状态写进缓存,改完要回后台重新保存一次固定链接,再清空 usr/cache,否则页面仍按旧规则生成链接。
验证
文章页、分类页、标签页全部返回 200,地址栏不再出现 index.php,后台伪静态检测显示通过。
小结
伪静态 404 九成是规则没进对 server 块,或者被 try_files 抢先匹配。先用 nginx -T 确认真实加载的配置,再按官方写法统一入口,最后清缓存复测,顺序不能反。
