链接生成规则失败？这5个原因最常见

你在配置网站重写规则、SEO友好的URL，或者用Nginx/Apache生成伪静态链接时，明明写了规则，但访问页面却404、跳转错乱、参数丢失——别急着删配置，先看看是不是这几个地方卡住了。

1. 路径匹配顺序搞反了

比如在Nginx里写了两条规则：

location /article/ {
    rewrite ^/article/(\d+)\.html$ /index.php?id=$1 last;
}
location /article/list {
    proxy_pass https://api.example.com/v1/articles;
}

问题来了：/article/list 会先被第一条规则匹配（因为 /article/ 是前缀通配），/list 被当成文章ID，结果转发到 /index.php?id=list，直接报错。实际要调换顺序，把更具体的 /article/list 放前面。

2. 正则表达式没转义特殊字符

想匹配 /user-2024-05.html，写成：
rewrite ^/user-(\d+)-(\d+).html$ /user.php?year=$1&month=$2;

这里 . 没转义，会被正则当成“任意字符”，导致 /user-2024X05.html 也能匹配上。正确写法是：\.（注意双反斜杠在Nginx配置中实际要写成 \.，而Apache里可能只需 \. 或 \.，视引擎而定）。

3. Rewrite标志用错了

last 和 break 看似差不多，但行为差很多：
– last：终止当前location匹配，重新发起内部URI匹配；
– break：停止重写，直接用当前URI去查找文件或代理。

如果在 location /api/ 块里用了 last 重写到 /v2/user，但没对应 location /v2/ 块，就会返回404；换成 break 可能就直接走文件系统找 /v2/user 了——得看你要的是“重定向逻辑”还是“路径替换”。

4. 后端程序没识别重写后的参数

Apache用 RewriteRule 把 /post/123 映射成 index.php?slug=123，但PHP里只读 $_GET['id']，自然拿不到值。常见于WordPress插件、自研CMS未适配重写后参数名，得检查程序入口是否解析了正确的键名，或者加 QSA（Query String Append）保留原始参数。

5. 开启了缓存却没刷新规则

改完Nginx配置 reload 了，但浏览器还记着301跳转；或者CDN缓存了旧的302响应；甚至WordPress插件（比如Redirection）自己缓存了规则匹配结果。这时候清浏览器DNS缓存、关掉CDN测试开关、进后台手动刷新插件缓存，往往比反复改配置更快见效。

链接生成不是写完就完的事，它卡在配置、正则、服务端、客户端四层之间。遇到失败，先抓个请求看真实跳转链（Chrome开发者工具Network → Preserve log），再对照这几条一条条过，90%的问题当场就能定位。