现象
为了把旧链接 /article/123 跳到新地址,在站点配置里加了 rewrite 规则,nginx -t 显示语法正确,reload 也执行成功,访问老地址依旧 404,error_log 里没有一条 rewrite 记录。
原因
规则可能写在了另一个 server 块里,实际请求命中的是 default_server;前面有更精确的 location 先匹配走了,rewrite 根本轮不到;rewrite 结尾没有写 last 或 break,处理完继续往下走,被后面的规则覆盖;宝塔面板保存站点时会重新生成配置,手改内容被覆盖;server_name 与实际域名不一致也会进错站点。
解决步骤
第一步,找到真正生效的 server 块。用 nginx -T 输出合并后的配置,确认规则所在的 server_name 与访问域名一致,并排除 80 与 443 只改了一个的情况。
nginx -T | grep -n -E "server_name|rewrite|return 301"
curl -I http://www.example.com/article/123
tail -n 30 /www/wwwlogs/nginx_error.log
第二步,把规则放到优先级更高的位置。rewrite 写在 location 之前,或用 location = 精确匹配旧路径,结尾加 last 重新匹配;保留参数时在目标地址后加 ?$args。
第三步,避免被面板覆盖。宝塔站点配置里把规则写进单独的 include 文件,面板重新生成时不会动它;改完先 nginx -t 再 reload,失败就不要重启,否则会把旧进程也带下去。
验证
curl -I 访问旧地址应返回 301 并带正确的 Location,跟随跳转后落地页为 200,error_log 不再报 404。
小结
rewrite 不生效通常不是语法问题,而是位置、优先级和面板覆盖。先用 nginx -T 确认真实配置,再用精确匹配加 last,最后把规则放进 include 文件固定下来。
