伪静态化改造中 Nginx URL 重写如何配

伪静态化改造的核心是让动态URL呈现静态路径外观而不改变后端逻辑，Nginx通过rewrite指令配合正则匹配实现，关键在于规则位置、匹配方式、flag选择及避免干扰其他逻辑。

伪静态化改造的核心，是让动态 URL 看起来像静态路径，同时不改变后端真实处理逻辑。Nginx 通过 rewrite 指令配合正则匹配实现，关键不在“怎么写一条规则”，而在于“写在哪、怎么匹配、用什么 flag、是否干扰其他逻辑”。

规则必须放在合适的 location 块里

不能直接写在 server 块顶层，否则易误匹配或失效。推荐按路径粒度绑定：

1. 针对整个站点的通用伪静态（如 Laravel/ThinkPHP 的入口统一处理），用 location / { }
2. 只对 /blog/ 下生效，就写 location ^~ /blog/ { } —— ^~ 表示前缀匹配优先，避免被正则 location 覆盖
3. 想精确匹配 /article/123.html 这类格式，用 location ~ ^/article/d+.html$ { }

正则写法要严谨，避免过度匹配

常见错误是没加边界符，导致 /news/123456789 匹配了 /news/123 规则。正确写法：

1. 匹配 /p/123.html → rewrite ^/p/(d+).html$ /index.php?p=$1 last;（^ 和 $ 锁定首尾）
2. 匹配带年月的博客路径 /blog/2024/05/hello → rewrite ^/blog/(d{4})/(d{2})/(.+)$ /blog/index.php?y=$1&m=$2&slug=$3 last;
3. 中文 slug 需客户端已编码，Nginx 默认能识别 %E4%B8%AD，无需额外 decode

flag 选错会导致跳转失败或循环

last 和 break 最常混淆，区别很实际：

1. 用 last：重写后新 URI（如 /index.php?p=123）会重新进入 location 匹配流程，适合转发给 PHP 处理 —— 这是伪静态的标准做法
2. 用 break：重写后停止所有 rewrite，也不再找新 location，只在当前块内继续执行后续指令（比如 proxy_pass），适合简单路径替换
3. 调试时可用 redirect（302）看浏览器地址是否变化；上线后 SEO 友好用 permanent（301）

更推荐 try_files 替代 if + rewrite

很多框架（如 WordPress、Typecho）习惯用 if (!-e $request_filename) 判断文件不存在再转发，但 Nginx 最新不建议在 location 外用 if。稳妥写法是：

1. location / { try_files $uri $uri/ /index.php?$query_string; }
2. 它先检查真实文件/目录是否存在，不存在才 fallback 到 index.php，性能更好、逻辑更清晰
3. 配合 fastcgi_param 正确传递 QUERY_STRING，PHP 才能拿到原始参数