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

配置 URI 重写与跳转

配置 URI 重写与跳转

本课介绍 Nginx 中 URI 处理的核心方式,帮助你区分内部重写和客户端跳转。完成学习后,可以使用 return、rewrite 和正则捕获组控制请求路径变化,并避免常见循环跳转问题。

学习目标

  • 理解 rewrite 与 redirect 的处理差异
  • 掌握 return、rewrite 指令的常见配置方式
  • 能够根据业务需求选择合适的状态码和匹配规则

理解内部重写与外部跳转

Nginx 处理 URI 变化时主要有两种方式:内部重写和外部重定向。内部重写只改变 Nginx 后续处理使用的 URI,浏览器地址栏不会变化;外部跳转会返回 HTTP 状态码,让客户端重新发起请求。

例如访问旧路径 /old 时,如果只是希望服务器内部读取 /new 对应资源,可以使用内部 rewrite;如果希望用户收藏的新地址变成 /new,则应该返回 301 或 302。

Nginx URI 重写与外部跳转处理流程图

使用 return 实现明确跳转

return 适合处理简单且确定的响应,例如固定跳转、状态码返回或快速拒绝请求。它不会继续执行复杂匹配逻辑,因此配置更容易预测。

nginx
server {
    listen 80;
    server_name example.com;

    location /old-path {
        return 301 /new-path;
    }
}

预期结果

text
客户端访问 /old-path
收到 HTTP/1.1 301 Moved Permanently
Location: /new-path
浏览器随后请求 /new-path

永久迁移使用 301,临时调整通常使用 302 或 307。生产环境切换域名、路径结构时,应确认缓存影响后再选择状态码。

使用 rewrite 匹配并替换 URI

rewrite 支持正则匹配,可以根据请求路径动态生成新 URI。它常用于旧接口兼容、路径整理和入口转换。

nginx
server {
    listen 80;

    location /user/ {
        rewrite ^/user/(.*)$ /account/$1 last;
    }
}

预期结果

text
请求:GET /user/tom
内部处理 URI:/account/tom
继续匹配新的 location

其中 last 表示完成 URI 修改后重新进入 location 匹配流程。break 则只在当前 location 内继续处理,选择错误可能导致请求进入非预期位置。

处理捕获组与循环跳转

rewrite 中的括号会产生捕获组,例如 (.*) 可以提取匹配内容,并通过 $1 引用。实际配置时应避免规则再次匹配自己产生的新 URI。

常见错误是将 /a 重写到 /a/,同时 /a/ 又触发相同规则,最终形成循环。

排查时可以检查响应头中的 Location,以及 Nginx access.log 中是否出现连续相同请求。

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

目录与阅读设置

阅读设置

17

记录一个想法

配置 URI 重写与跳转

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

登录哪都通