Web 服务器与网关 / 系统课时
rewrite 适合处理什么路径
rewrite 适合处理什么路径
路径中需要提取编号、调整结构或兼容旧路由时,rewrite 可以按正则匹配并替换 URI。本篇用商品编号示例区分内部重写和客户端跳转,再检查参数与 location 重选,避免把复杂规则写成难以预测的循环。
学习目标
- 用有限的正则捕获完成明确路径映射。
- 区分 last、break 与返回重定向的行为。
- 验证查询参数、未命中路径和内部处理结果。
先判断客户端是否应该换地址
旧 API 路径需要兼容而客户端地址暂时不变时,可内部重写;公开文档迁移希望客户端知道新地址时,应返回重定向。两者最终都可能拿到同一份内容,但网络交互不同。

rewrite 匹配的是当前规范化 URI 路径,不包含查询字符串。正则只捕获业务需要的部分,例如数字编号;不要用过宽的 .* 规则吞掉所有接口、资源与错误路径。
用 last 重选目标 location
以下片段示例位于 Nginx 1.28 的 http,依赖本机空闲 8080。数字映射是内部处理,旧文档则明确返回永久跳转:
server {
listen 127.0.0.1:8080;
server_name rewrite.test;
location /legacy/item/ {
rewrite ^/legacy/item/([0-9]+)$ /items/$1 last;
return 404;
}
location ~ ^/items/[0-9]+$ {
return 200 "uri=$uri args=$args\n";
}
location /old-guides/ {
rewrite ^/old-guides/(.+)$ /guides/$1 permanent;
return 404;
}
location /guides/ { return 200 "guide-ok\n"; }
location / { return 404; }
}last 结束当前这组 rewrite 指令,以改写后的 URI 再寻找 location;因此数字路径不再执行原 location 中的 return 404。break 结束当前这组重写指令后继续当前 location 的处理,不替你重选上述 /items/ 规则,不能把它作为同义词替换。
查看内部 URI 与外部 Location
检查并重载后运行:
# 内部改写直接得到 200;外部改写先观察 301。
curl --noproxy '*' --resolve rewrite.test:8080:127.0.0.1 -sS -w 'status=%{http_code}\n' 'http://rewrite.test:8080/legacy/item/42?lang=zh'
curl --noproxy '*' --resolve rewrite.test:8080:127.0.0.1 -sS -o /dev/null -D - http://rewrite.test:8080/old-guides/start第一条预期输出:
uri=/items/42 args=lang=zh
status=200第二条状态为 301,Location 为 http://rewrite.test:8080/guides/start;跟随后才得到 guide-ok。请求 /legacy/item/abc 应为 404,证明只接受定义好的编号结构。
参数变化与循环要显式设计
本例替换串没有新查询参数,原有参数得到保留。若替换串自己包含参数,旧参数通常会追加;若不希望追加,应按语法在替换串末尾加问号。可单独在原 server 中加入以下片段示例验证:
# 片段依赖上面的 server;最终 args 只应是 id=42。
location /lookup/ {
rewrite ^/lookup/([0-9]+)$ /show?id=$1? last;
return 404;
}
location = /show { return 200 "args=$args\n"; }请求 /lookup/42?debug=1 应得到 args=id=42,不含 debug。规则顺序、标志及参数语义见 Nginx rewrite 文档。
避免目标 URI 再次命中同一改写而不停重选 location。对于静态文件存在性使用 try_files,固定地址使用 return;只有需要路径结构转换时才增加 rewrite,并为未命中与边界输入保留明确结果。