只要站点上了 HTTPS 并且带 www 与非 www 两个入口,301 重定向就是绕不过去的一件事。看起来也很简单:在 Nginx 里加一句 return 301 就完了。但实践里翻车的方式非常多——重定向环、混合内容、POST 请求丢失、CDN 缓存了 301 导致改不回来、旧域名与旧路径同时要跳、以及最隐蔽的一种:跳转是通的,但搜索引擎把 301 缓存了三周,你以为没生效。
这篇文章按「入口从外到内、规则从宽到窄」的顺序,把默认站点的配置写完整,并逐项验证。目标不是给你一份能抄的配置,而是让你在出现问题时知道该看哪一层。
一、先把「谁是默认入口」这件事定下来
301 的所有混乱都源于一个没想清楚的决策:全站唯一正确的形态是什么。四个可能性必须选一个,其余三个全部 301 过去:
https://www.example.com(带 www、HTTPS)——最常见,也最适合需要 CDN 与证书管理的场景;https://example.com(裸域、HTTPS)——短,但裸域一般不能上 CDN 的 CNAME,只能做 A 记录;- HTTP 版本的两个形态——永远只是过渡,不作为最终形态。
定下来之后,把它写进一张纸:唯一形态 = https + www + 小写路径 + 无结尾斜杠(或统一带斜杠)。后面所有规则都是这句话的展开。没定这张纸就开始写配置,必然出现「有时带 www、有时不带」的站内链接,也必然出现两套 URL 抢同一个页面的情况。
选 www 还是裸域,从技术上没有对错,但有三个现实约束值得算一下:裸域无法使用 CNAME,意味着换 CDN 或换 IP 时要改根记录;裸域的 cookie 会作用到所有子域名,如果以后要开二级站点会互相干扰;证书方面两者都能签,但通配符证书只覆盖 *.example.com,不覆盖裸域,所以实践中常常是两个都签或者用带裸域的 SAN 证书。
二、最小可用的两段式配置
最稳的结构是分成两个 server 块:一个专门做跳转,一个专门处理请求。跳转块只做一件事,不加载任何业务配置——这样即使业务配置写错了,跳转本身还能工作,是排查时的保底通道。
# 跳转专用:把 http、裸域,以及两者组合,全部收口到 https://www
server {
listen 80 default_server;
listen [::]:80 default_server;
server_name example.com www.example.com _;
# 保留原始路径与查询串
return 301 https://www.example.com$request_uri;
}
server {
listen 443 ssl default_server;
listen [::]:443 ssl default_server;
http2 on; # nginx 1.25.1+ 的写法;老版本用 listen 443 ssl http2;
server_name example.com;
ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
return 301 https://www.example.com$request_uri;
}这里有三个细节值得单独说明。
为什么用 $request_uri 而不是 $uri。$uri 是规范化之后的路径,不含查询串;$request_uri 是客户端原始请求的完整 URI,包含 ?a=1&b=2。用 $uri 会把搜索参数、追踪参数全部丢掉——用户在搜索结果里点了一个带参数的链接,落地页变成了无参数版本,统计分析全线失真。唯一需要小心的是 $request_uri 也可能包含恶意构造的路径,但在「只做跳转、不落盘」的 server 块里风险可控。
为什么 http 块里把 example.com 和 www.example.com 都写上。这样 http 的两个形态一跳到位,而不是「http://example.com → https://example.com → https://www.example.com」的两次跳转。跳转链越长,丢失参数的概率和延迟越高,搜索引擎也会把多跳视为质量问题。一条规则一次到位,是这条配置最重要的价值。
为什么 default_server。没有它的话,如果有人把别的域名解析到这台机器的 IP,Nginx 会把这个请求交给第一个 server 块处理,返回你站点的内容。这在技术上叫「主机头污染」,SEO 上会造成内容被镜像。加上 default_server 并用 _ 兜底,可以让陌生 Host 落到你控制的处理逻辑上。
三、POST、API 与例外路径:301 不能一刀切
301 会让浏览器把 POST 改成 GET,并丢掉请求体。如果站点里有表单提交、API 接口、回调地址,一刀切的 301 会直接把它们打坏。正确做法是在跳转块里给这些路径留出口:
server {
listen 80 default_server;
server_name example.com www.example.com _;
# 支付回调、第三方 webhook 这类不能跳的路径,直接给业务处理
location ^~ /callback/ {
proxy_pass http://127.0.0.1:8080;
proxy_set_header Host $host;
include proxy_params;
}
location = /healthz {
access_log off;
return 200 "ok\n";
add_header Content-Type text/plain;
}
return 301 https://www.example.com$request_uri;
}注意 Nginx 的匹配优先级:location = 精确匹配最高,其次 ^~ 前缀匹配,然后才是正则和普通前缀。把例外放在 return 301 之前,它们就不会被跳走。这一步做完,用 curl -X POST -d 'a=1' 打一次回调地址,确认返回的是业务响应而不是 301。
另一种情况是「只有部分页面要跳,其余不动」。比如把旧栏目 /old-blog/ 整体迁到 /blog/,这时候不要用 server 级的 return,而是在业务 server 块里用 location 级的 rewrite:
location ^~ /old-blog/ {
rewrite ^/old-blog/(.*)$ /blog/$1 permanent;
}permanent 就是 301,redirect 是 302。迁移用 301,临时活动页用 302。用错了的后果是:本该保留权重的迁移用了 302,权重不传递,几个月后两边都没排名。
四、为什么「我改了配置但页面还是 301 到旧地址」
这是最典型的假故障,原因通常在你改不到的地方。按从外到内的顺序检查这五层:
第一层:浏览器缓存。301 是可缓存的,而且很多浏览器对 301 的缓存没有过期时间概念,会一直记着。验证方法是用 curl -sI 直接发请求,不受浏览器缓存影响。如果 curl 看到的是新规则,浏览器还是老的,清一下站点数据即可,不是服务器问题。
第二层:CDN 边缘缓存。如果 301 响应被 CDN 缓存了,源站改了也没用。检查响应头里的 Age、X-Cache、CF-Cache-Status 之类的字段,如果是 HIT 就说明命中的是缓存。处理方式是刷新对应 URL 的缓存,并且长期做法是给跳转响应加上 Cache-Control: no-store 或者很短的 max-age,避免下次再被粘住。
# 加上 no-store,避免 301 被 CDN 和浏览器长期缓存
add_header Cache-Control "no-store" always;第三层:HSTS。如果曾经给裸域发过 Strict-Transport-Security 头,浏览器会在有效期内强制走 HTTPS,且不再询问。这个策略反向也会造成困扰:你在 http 上做的测试永远看不到 80 端口的真实响应。验证 HSTS 是否生效,看响应头 strict-transport-security 的 max-age。
第四层:搜索引擎自己的缓存。搜索引擎抓到 301 后会保留一段时间,这个时间不由你控制。如果旧 URL 之前被索引且跳转目标被判定为等价,它可能几周内都还在展示旧 URL。这不是故障,是延迟。确认方法是在搜索后台的 URL 检查工具里看「Google 选择的规范网址」是不是新地址。
第五层:你自己的规则写错了。最常见的是两个 server 块互相跳:80 块跳到 https://www,443 的 www 块里又有一条跳回裸域,形成环。浏览器会报 ERR_TOO_MANY_REDIRECTS。curl -sSIL --max-redirs 10 可以一眼看出链条,输出里看到同一个 URL 出现两次就是环。
curl -sSIL --max-redirs 10 "http://example.com/some/page.html?a=1" | grep -Ei '^(HTTP/|location:)'这条命令是排查跳转问题的第一把工具。它按顺序打印每一跳的状态码和 Location,一条链几秒钟就看完了。养成习惯:改完跳转规则先跑它,而不是开浏览器。
五、混合内容:跳转做对了,页面还是「不安全」
全站上 HTTPS 之后,浏览器地址栏的小锁可能仍然带着警告,或者控制台报一片红色。这是混合内容:页面本身是 HTTPS,但里面引用了 http 的资源。图片、脚本、样式表、iframe、字体,任何一项都可能踩到。
查找方法有两种。第一种是看控制台,现代浏览器会直接列出被拦截的地址,但只列当前页面加载到的。第二种更彻底:抓 HTML 源码,把所有 http:// 开头的引用列出来。
curl -s "https://www.example.com/" | grep -oE '(src|href)="http://[^"]+"' | sort -u | head -30站长的老文章里往往有一批写死的 http 图片地址。这类问题有两个层次的修法:治标是用 Nginx 的 sub_filter 在响应里替换,或者在 head 标签里加 Content-Security-Policy: upgrade-insecure-requests 让浏览器自动把 http 升级成 https;治本是批量改数据库里的正文。
upgrade-insecure-requests 有个前提:目标资源必须真的支持 https。如果图片服务器只有 http,升级之后全部 404,页面会变得比之前更糟。所以正确顺序是:先 grep 出所有外链域名,逐个测试 https 是否可用,再决定哪些升级、哪些换掉。这一步偷懒,会换来一堆破图。
六、收尾验证清单
配置上线后,按这张表逐项验证。全部通过才算完成,任何一项不通过都不要急着宣布「搞定了」:
- 四个入口各打一次:http 裸域、http www、https 裸域、https www,前三个都应该是 301 且 Location 指向 https://www 版本。
- 参数是否保留:带
?a=1&b=2请求一次,看 Location 里两个参数是否都在。 - 跳转跳数:
curl -sSIL --max-redirs 10应只有一跳,最多两跳,不能出现环。 - POST 是否被保活:回调路径用
curl -X POST打一次,返回不是 301。 - 静态资源与深度路径:抽三个
/a/b/c.html这样的多级路径,确认重定向后路径完整。 - 证书是否覆盖跳转目标:裸域的 https 块也要有证书,否则 https://example.com 会在 TLS 握手阶段失败,根本走不到 301——这是新手最常踩的坑,表现为「浏览器直接报连接不安全」,而不是跳转。
- HSTS 头是否合理:刚上线阶段建议
max-age先设小一点(比如 300 秒),跑一周没问题再往长调。设成一年之后发现某个子域只有 http,就很难回头了。
关于第六项再强调一次:server_name example.com 的 443 块如果没有有效证书,Nginx 会尝试用别的证书去握手,客户端校验失败。所以「裸域 js 跳转到 www」这套做法在 HTTPS 下必须两步都做对——DNS 要指向这台机器,证书要覆盖裸域,然后才谈得上 301。很多人以为配了 301 就够了,结果裸域根本连不上,白白丢了裸域入口的所有流量。
七、小结:301 是一次性的架构决定
301 配置本身只有几行,但它是少数「写下去就很难撤回」的配置之一——因为它会被浏览器、CDN、搜索引擎三层缓存。所以在写之前要把那张纸定下来:唯一形态是什么、哪些路径例外、证书覆盖哪些域名、HSTS 要不要开、多久之后再开。写完之后用这份清单验证,用 curl 而不是浏览器确认效果。
真正区分老手和新手的,不是配置写得多漂亮,而是改之前就想过「这条规则三个月后怎么撤」。撤得干净的配置才是好配置;撤不干净的,早晚会在某次换域名、换 CDN、换证书的时候把你困住。