URL重写是一项非常重要的功能。它不仅可以提升用户体验、规范网站URL结构，还对搜索引擎优化(SEO)有积极作用。作为一款高性能的Web服务器，Nginx原生支持强大的重写机制，通过rewrite、return以及location指令的组合，可以灵活地实现各种URL重定向与跳转需求。

Nginx中实现URL重写的三种常见方式：

1. rewrite指令：用于内部重写或发起301/302跳转

rewrite 正则表达式 替换路径 [flag];

常见flag：

last：停止当前规则处理，重新开始匹配location;

break：停止执行重写，继续当前location中的配置;

redirect：返回临时重定向(302);

permanent：返回永久重定向(301)。

2. return指令：快速响应状态码和跳转地址

return 301 https://example.com$request_uri;

更简洁的301重定向方式，推荐用于整站跳转或域名重定向。

3. location匹配块：结合重写提高精准度

通过location可精细匹配URI段，有助于只对特定路径执行重写规则。

Nginx URL重写的基础语法说明

Nginx重写规则采用正则表达式进行路径匹配，其结构如下：

rewrite ^/old-path/(.*)$ /new-path/$1 permanent;

说明：

^/old-path/(.*)$：匹配以 /old-path/ 开头的地址;

/new-path/$1：将匹配到的路径变量替换至新路径;

permanent：表示使用301跳转，有助于SEO权重传递。

实战案例：常见URL重写配置示范

案例一：将动态链接转换为伪静态链接

将原始URL如 /product.php?id=123 转为 /product/123.html

location /product {
    rewrite ^/product/([0-9]+)\.html$ /product.php?id=$1 last;
}

这对搜索引擎更友好，也有利于用户记忆。

案例二：整站HTTP跳转到HTTPS

实现HTTPS加密访问的强制跳转：

server {
    listen 80;
    server_name www.example.com;

    return 301 https://$host$request_uri;
}

适用于全站强制加密，避免混合内容与SEO惩罚。

案例三：非www跳转到www

server {
    listen 80;
    server_name example.com;

    return 301 $scheme://www.example.com$request_uri;
}

通过统一域名入口，集中搜索权重，提升排名稳定性。

案例四：旧版URL重定向到新路径

将 /news/detail?id=88 映射为 /article/88.html

location /news/detail {
    rewrite ^/news/detail\?id=([0-9]+)$ /article/$1.html permanent;
}

注意：此类包含查询参数的重写需结合if条件使用：

if ($arg_id) {
    rewrite ^/news/detail$ /article/$arg_id.html permanent;
}

案例五：屏蔽访问某类目录

禁止用户访问 .git 或 .svn 目录：

location ~ /\.(git|svn) {
    deny all;
}

案例六：老域名整体跳转至新域名

server {
    listen 80;
    server_name olddomain.com;

    return 301 https://newdomain.com$request_uri;
}

适合网站迁移后的跳转处理，保留原始路径利于SEO过渡。

URL重写中的变量说明

Nginx支持一系列变量，在URL重写时非常有用：

• $host：请求的主机名;
• $request_uri：完整的请求路径(不含协议和域名);
• $uri：请求URI路径部分;
• $args：请求参数部分(如id=1&name=test);
• $arg_name：获取指定参数名的值。

这些变量可以灵活组合，实现复杂的跳转需求。

重写规则的生效流程与调试技巧

1. 重写规则生效顺序

server块的rewrite指令先执行;

匹配到location后，再执行location内的rewrite;

多个rewrite规则按顺序执行，last会重新匹配location。

2. 常见调试方法

使用命令测试语法正确性：

sudo nginx -t

查看访问日志 /var/log/nginx/access.log

设置 error_log 等级为 notice 查看重写信息：

error_log /var/log/nginx/error.log notice;

错误示范与注意事项

错误示例一：错误使用rewrite导致死循环

rewrite ^/(.*)$ /$1 last;

这样的规则等于什么也没做，可能陷入无限循环，应避免无意义重写。

错误示例二：未指定重写标志位

rewrite ^/abc/(.*)$ /xyz/$1;

未指定 last、permanent 等标志，Nginx默认内部重写，无法跳转页面，务必加上标志位。

通过本文的系统讲解，我们建议：基础重写规则需熟练掌握，包括正则表达式和变量应用；场景化配置有利于架构灵活性，例如模块跳转、目录兼容;结合SEO需求进行规则设计，避免页面权重损失；注意调试与语法验证，保持高可用与安全性。

在网站架构日趋复杂的今天，URL重写不仅仅是一次页面跳转的动作，更是一种链接管理的策略思维。通过Nginx构建稳定、灵活、SEO友好的URL结构体系，将助力企业与开发者打造更具搜索价值的网站产品。