Web 服务器与网关 / 系统课时

rewrite 适合处理什么路径

rewrite 适合处理什么路径

路径中需要提取编号、调整结构或兼容旧路由时,rewrite 可以按正则匹配并替换 URI。本篇用商品编号示例区分内部重写和客户端跳转,再检查参数与 location 重选,避免把复杂规则写成难以预测的循环。

学习目标

  • 用有限的正则捕获完成明确路径映射。
  • 区分 last、break 与返回重定向的行为。
  • 验证查询参数、未命中路径和内部处理结果。

先判断客户端是否应该换地址

旧 API 路径需要兼容而客户端地址暂时不变时,可内部重写;公开文档迁移希望客户端知道新地址时,应返回重定向。两者最终都可能拿到同一份内容,但网络交互不同。

内部重写在 Nginx 内重选处理规则,外部跳转让客户端重新请求

rewrite 匹配的是当前规范化 URI 路径,不包含查询字符串。正则只捕获业务需要的部分,例如数字编号;不要用过宽的 .* 规则吞掉所有接口、资源与错误路径。

用 last 重选目标 location

以下片段示例位于 Nginx 1.28 的 http,依赖本机空闲 8080。数字映射是内部处理,旧文档则明确返回永久跳转:

nginx
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

检查并重载后运行:

bash
# 内部改写直接得到 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

第一条预期输出:

text
uri=/items/42 args=lang=zh
status=200

第二条状态为 301,Location 为 http://rewrite.test:8080/guides/start;跟随后才得到 guide-ok。请求 /legacy/item/abc 应为 404,证明只接受定义好的编号结构。

参数变化与循环要显式设计

本例替换串没有新查询参数,原有参数得到保留。若替换串自己包含参数,旧参数通常会追加;若不希望追加,应按语法在替换串末尾加问号。可单独在原 server 中加入以下片段示例验证:

nginx
# 片段依赖上面的 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,并为未命中与边界输入保留明确结果。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

rewrite 适合处理什么路径

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通