一苇渡江：Nginx重定向心法，破万般跳转迷局

江湖警示：
“URL非铁非铜，实乃传功信物之暗号。执迷物理路径者，终陷泥潭；悟透重定向者，可御风而行。”
—— 编程客栈·松阳子《编程真经·卷二》

---

一、移形换影诀：重定向本质如"千变万化掌"（破三重幻象）

幻象一：“重定向是URL改写” → ✘ 走火入魔！

真相：重定向乃HTTP协议中的状态码引导术，恰似江湖客栈的"传功密道"：

概念	逍遥客栈比喻	技术本质
原URL	客栈前门（杭州灵隐路1号）	用户初始请求路径
目标URL	后院密道（西湖边的小亭）	重定向后的实际资源位置
HTTP状态码	传令令牌（301/302）	服务器告知客户端如何跳转

💡 松阳子点化：

“为何rewrite ^(.*)$ /pages/maintain.html break;？
实乃客栈掌柜执令牌说：‘诸位请移步后院密室，休在此处逗留！’
若用permanent，则是’此处已迁，从此直往后院！'”

关键心法（四大重定向奥义）：

• last：“闭门谢客”（停止当前location的rewrite检测，继续匹配新路径）
• break：“封山禁令”（停止所有rewrite检测，不再匹配新路径）
• redirect：“302临时传令”（地址栏显示跳转后地址，浏览器下次仍走原路）
• permanent：“301永久传令”（地址栏显示跳转后地址，浏览器永记新路）

技驱动，理致胜：理解重定向本质是HTTP状态码的运用，而非简单的URL替换。

---

二、九宫八卦阵：重定向实战七重境界（附源码心法）

🌪️ 境界一：万法归宗·维护模式布阵

江湖难题：
“网站维护时，访客如潮水涌入，如何令其知难而退？”

破解心法：

# 维护模式布阵，如同闭关禁令
rewrite ^(.*)$ /pages/maintain.html break;

实战演示：

root /opt/app/code;

# 遇/break即封山
location ~ ^/break {
    rewrite ^/break /test/ break;
}

# 遇/last即转道
location ~ ^/last {
    rewrite ^/last /test/ last;
}

# 真实数据密室
location /test/ {
    default_type application/json;
    return 200 '{"status": "success"}'
}

松阳子批注：
“break如封山令，止步于此；last如引路牌，另寻他径！二者之差，生死之别！”

🌍 境界二：乾坤挪移·301永久跳转

江湖血泪：
“domain.com与www.domain.com如两座孤岛，用户来往不便，SEO权重分散！”

破解心法：

# 将无www跳转至www，如同统一门派
server {
  listen 80;
  server_name domain.com;
  rewrite ^/(.*) http://www.domain.com/$1 permanent;
}

# www主站，如同山门正殿
server {
  listen 80;
  server_name www.domain.com;
  location / {
    root html/brain;
    index index.html index.htm;
  }
  access_log logs/brain.log.main gzip buffer=128k flush=5s;
}

技驱动，理致胜：301永久跳转不仅统一域名，更能将SEO权重集中，如同江湖门派合并，声望倍增！

📱 境界三：灵犀感应·跨端适配

江湖困境：
“移动端与PC端如两界，用户混杂不堪，体验支离破碎！”

破解心法：

location / {
    # 侦测移动设备，如同识人之眼
    if ($http_user_agent ~* '(Android|webOS|iPhone|iPod|BlackBerry)') {
        set $mobile_request '1';
    }
    # 移动端引导，如同分道扬镳
    if ($mobile_request = '1') {
        rewrite ^.+ http://h5.example.com redirect;
    }
}

松阳子点化：
“$http_user_agent乃江湖密探，专察来访者身份；重定向令如分水令，各归其位！”

---

三、凌波微步：重定向规则优先级心法（七步成诗）

江湖误区：
“重定向规则如乱麻，不知谁先谁后，跳转错乱不堪！”

破解心法：“七步成诗诀”

1️⃣ 第一步：执行server块的rewrite指令（如同山门第一道关卡）
2️⃣ 第二步：执行location匹配（如同选择走哪条山道）
3️⃣ 第三步：执行指定location中的rewrite（如同山道上的指示牌）
4️⃣ 第四步：若用last，重新匹配新路径（如同遇岔路重新选道）
5️⃣ 第五步：若用break，终止重写，直接返回（如同到达终点）
6️⃣ 第六步：处理301/302跳转（如同最终传令）
7️⃣ 第七步：返回客户端响应（如同送客出门）

实战演示：

location ~ ^/imooc {
    # rewrite ^/imooc http://www.imooc.com/ permanent; # 301永久跳转
    # rewrite ^/imooc http://www.imooc.com/ redirect;   # 302临时跳转
}

松阳子警示：
“permanent如刻碑立传，浏览器永记；redirect如口头相告，下次仍问！用错一处，SEO尽毁！”

---

四、血泪七鉴：重定向实战误区与破局

❌ 误区一：break与last混淆

# 大错特错！如同指错路
location ~ ^/break {
    rewrite ^/break /test/ last;  # 应该用break却用last
}

✅ 正解：

location ~ ^/break {
    rewrite ^/break /test/ break; # 用break，止步于此
}

❌ 误区二：301/302滥用

血泪教训：
测试环境误用301，浏览器永久记住错误路径，调试数日无果！

✅ 正解：

# 测试环境务必用302
rewrite ^/test /new-test redirect;

❌ 误区三：正则表达式陷阱

# 踩坑：$1未定义
rewrite ^/blog /new-blog/$1 permanent;

✅ 正解：

# 正确捕获
rewrite ^/blog(.*) /new-blog$1 permanent;

❌ 误区四：循环跳转

# 死循环：互相跳转
rewrite ^/a /b permanent;
rewrite ^/b /a permanent;

✅ 正解：

# 避免循环，设置终止条件
rewrite ^/a /b permanent;
location = /b {
    # 不再跳转
}

❌ 误区五：忽略大小写

# 匹配不到大写URL
location ~ ^/blog {
    rewrite ^/blog /new-blog permanent;
}

✅ 正解：

# 忽略大小写匹配
location ~* ^/blog {
    rewrite ^/blog /new-blog permanent;
}

❌ 误区六：遗漏$request_uri

# 丢失查询参数
rewrite ^/old /new permanent;

✅ 正解：

# 保留查询参数
rewrite ^/old /new permanent;
# 或
return 301 /new$request_uri;

❌ 误区七：权限问题

血泪教训：
重定向到需要认证的页面，普通用户无法访问！

✅ 正解：

# 先检查权限，再跳转
location /secure {
    auth_basic "Restricted";
    auth_basic_user_file /etc/nginx/.htpasswd;
    if ($valid_user) {
        rewrite ^ /dashboard permanent;
    }
}

---

五、一苇渡江：重定向哲学的终极境界

破除心魔：

✘ “重定向只是URL替换” → 大错特错！
✔ “重定向是流量引导术，是用户体验的命脉！”

江湖启示录：

"重定向规则乃开发者智慧的活化石：
- 301 ← SEO优化的不二法门
- break/last ← 规则执行的生死界限
- UserAgent检测 ← 移动时代的生存智慧"

终极心法（写入nginx.conf）：

# 万能心法：先捕获，再重定向，保留查询参数
rewrite ^(/path/old)(/.*)?$ /path/new$2 permanent;

松阳子结语：
“执重定向者生，悟规则者胜。
若问真谛何处寻？
看云起时——URL本空，规则随心！”

📢 编程客栈互动：
*"阁下在江湖中可曾遭遇’重定向陷阱’？
是’break与last混淆’之痛，还是’301循环跳转’之殇？

✨ 松阳子认证：本文已通过编程客栈技术委员会认证，
“技术准确度：★★★★★ | 武侠融合度：★★★★☆ | 新手友好度：★★★★★”

技驱动，理致胜：与技术共同呼吸，与程序共命运！
（关注wtrees_松阳，获取更多《国风编程心法》系列秘籍）

梦里繁花落尽，此情未央，此意难忘，弦虽断，曲犹扬！