NET::ERR_TOO_MANY_REDIRECTS 全解:HTTPS 重定向循环的根因定位与修复
浏览器打开站点直接白屏,控制台报 NET::ERR_TOO_MANY_REDIRECTS(Firefox 显示“该页面无法正确重定向”,Safari 显示“重定向过多”)。Chrome 内核在单次导航中最多跟随 20 次重定向,curl 默认上限 50 次,超过即中断。这个报错与证书、DNS 无关,本质是 HTTP 301/302/307/308 形成了闭环。
最常见的闭环链路:客户端请求 http://example.com → CDN 边缘返回 301 到 https://example.com → 客户端用 HTTPS 访问 CDN → CDN 以 HTTP 回源 → 源站 Nginx 看到 $scheme = http,又返回 301 到 HTTPS → CDN 把这条 301 透传给客户端 → 客户端再次请求 → 死循环。整条链路里,客户端始终在 HTTPS 上,但源站始终认为自己在处理 HTTP,于是无休止地“纠正”协议。
根因可归为四类,按出现频率排序:
| 类别 | 典型表现 | 出现频率 |
|---|---|---|
| CDN 回源协议与源站跳转策略冲突 | Cloudflare Flexible SSL、CDN 回源选 HTTP | 最高 |
| 源站判断协议用错变量 | 用 $scheme 而非 X-Forwarded-Proto |
高 |
| 多层重复跳转 | Nginx + .htaccess + WordPress 插件同时跳 | 中 |
| 应用配置不一致 | siteurl 与 home 一 http 一 https |
中 |
关键认知只有一句:重定向只能在一层做。要么在 CDN 边缘完成(推荐),要么在源站完成;两层都做且判断依据不一致,必然打架。另外,源站“回源 HTTPS”依赖有效证书,公开信任的 TLS 证书单张最长有效期为 398 天,Let’s Encrypt 为 90 天,必须配置自动续期。证书过期后报错会从重定向循环变成 Cloudflare 526 或 ERR_SSL_PROTOCOL_ERROR,排查方向完全不同。
第一步:用 curl 和 DevTools 抓出跳转链
定位循环点的核心工具是 curl -IL,配合 grep 过滤状态行与 Location 头。
curl -sIL --max-redirs 10 http://example.com
| grep -Ei '^(HTTP/|location:|server:|cf-ray:|x-cache:|via:)'
参数含义:-I 只发 HEAD 请求取响应头,-L 跟随重定向,-s 静默模式,--max-redirs 10 限制跟随次数避免刷屏,grep -Ei 忽略大小写并同时匹配多个头。典型输出如下:
HTTP/1.1 301 Moved Permanently
Location: https://example.com/
Server: cloudflare
HTTP/2 301
Location: http://example.com/
Server: nginx/1.24.0
HTTP/1.1 301 Moved Permanently
Location: https://example.com/
Server: cloudflare
curl: (47) Maximum (50) redirects followed
看到 Server: cloudflare 与 Server: nginx 交替出现,就说明跳转在 CDN 与源站两层之间来回弹。若连续两次 301 的 Location 完全相同(例如都是 https://example.com/),则是同一层在自我循环,通常是 WordPress 的 siteurl 与 home 不一致,或 HSTS 与跳转规则叠加导致。
用一条命令量化跳转次数与最终落点:
curl -o /dev/null -sIL -w 'redirects=%{num_redirects} final=%{url_effective} code=%{http_code}n'
--max-redirs 10 http://example.com
浏览器侧:DevTools → Network,勾选 Preserve log(保留日志)与 Disable cache,地址栏输入 http:// 开头的 URL,逐条查看 301 响应的 Location、Server、cf-ray、x-cache,即可判断跳转由哪一层返回。注意浏览器会缓存 301(RFC 9110 允许永久缓存),排查时务必用无痕窗口,或在 chrome://net-internals/#hsts 中清除已记录的域名。
源站侧同时观察日志:tail -f /var/log/nginx/access.log,并在 log_format 中临时加入 $scheme 与 $http_x_forwarded_proto,就能确认源站到底收到了什么协议、CDN 有没有传转发头。
根因一:CDN 回源协议配置错误
这是占比最高的原因。以 Cloudflare 为例,SSL/TLS → Overview 中的加密模式决定了 CDN 到源站这一段用什么协议:
| 加密模式 | 客户端 ↔ CDN | CDN ↔ 源站 | 源站强制 HTTPS 时 | 建议 |
|---|---|---|---|---|
| Off | HTTP | HTTP | 必然循环 | 禁用 |
| Flexible | HTTPS | HTTP | 必然循环 | 仅临时测试 |
| Full | HTTPS | HTTPS(不校验证书) | 不循环 | 自签证书场景 |
| Full (strict) | HTTPS | HTTPS(校验证书与域名) | 不循环 | 生产环境推荐 |
修复动作:把模式改为 Full (strict),并在 Edge Certificates 中开启 Always Use HTTPS。这样 HTTP→HTTPS 的 301 在边缘节点完成,源站只处理 HTTPS 请求,链路中只剩一层跳转。若源站使用自签证书,Full (strict) 会报 526,此时要么换成 Let’s Encrypt 证书,要么暂时用 Full。
国内云厂商的配置项名称不同,但语义一致:阿里云 CDN 在“域名管理 → HTTPS 配置 → 回源协议”中选择 HTTPS 或“协议跟随”;腾讯云 CDN 在“回源配置 → 回源协议”中设置。选择“协议跟随”时要确认边缘收到的就是 HTTPS,否则仍可能回源 HTTP。
改完后用以下命令确认源站 443 正常、边缘已生效:
curl -sI https://example.com | grep -Ei 'server|cf-ray|strict-transport'
openssl s_client -connect example.com:443 -servername example.com /dev/null
| openssl x509 -noout -subject -dates
证书 notAfter 应落在合理区间:Let’s Encrypt 为 90 天,商业证书不超过 398 天。若显示已过期,先续期再谈跳转,否则问题会伪装成握手失败。
根因二:源站跳转判断逻辑用错变量
反代或 CDN 回源后,源站看到的连接协议是 http,真实客户端协议被放在 X-Forwarded-Proto 头里。若源站直接判断 $scheme,就会误判并再次跳转。Nginx 正确写法是用 map 归一化:
map $http_x_forwarded_proto $client_scheme {
default $scheme;
http http;
https https;
}
server {
listen 80;
server_name example.com www.example.com;
if ($client_scheme = http) {
return 301 https://$host$request_uri;
}
root /var/www/html;
index index.php index.html;
}
逻辑说明:CDN 以 HTTP 回源但携带 X-Forwarded-Proto: https 时,$client_scheme 为 https,源站直接返回内容,不再跳转;客户端直连 80 端口且没有该头时,$client_scheme 为 http,才执行 301。map 必须写在 http 块内、server 块之外。
Apache 的 .htaccess 等价写法:
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteCond %{HTTP:X-Forwarded-Proto} !https
RewriteCond %{HTTPS} !=on
RewriteRule ^(.*)$ https://%{HTTP_HOST}%{REQUEST_URI} [R=301,L]
</IfModule>
WordPress 还需要在 wp-config.php 的 /* That's all, stop editing! */ 之前补一段,让 PHP 认识到当前是 HTTPS,否则后台会继续跳:
if (isset($_SERVER['HTTP_X_FORWARDED_PROTO'])
&& strpos($_SERVER['HTTP_X_FORWARDED_PROTO'], 'https') !== false) {
$_SERVER['HTTPS'] = 'on';
}
改完执行 nginx -t && nginx -s reload 或 apachectl configtest 验证语法。切勿在 443 的 server 块里再写一条“如果没开 HTTPS 就跳 HTTPS”的规则,那是最常见的自环写法。
根因三:多层重复跳转与 WordPress 配置冲突
当 Nginx、.htaccess、WordPress 插件三处同时配置了强制 HTTPS,任何一处判断失误都会被放大成循环。先用一条命令把所有跳转规则找出来:
grep -rniE 'return 301|rewrite .*https|Redirect permanent|RedirectMatch'
/etc/nginx/ /etc/apache2/ /var/www/html/.htaccess 2>/dev/null
再检查 WordPress 的两个地址是否一致(协议、域名、是否带 www 都必须完全相同):
wp option get home --allow-root
wp option get siteurl --allow-root
wp plugin list --status=active --allow-root
若输出中一个是 http://example.com、另一个是 https://www.example.com,WordPress 核心会不断把请求重定向到 canonical 地址,与外层规则叠加后形成循环。用 wp option update home https://example.com 与 wp option update siteurl https://example.com 统一即可。Really Simple SSL 这类插件的“启用 .htaccess 301 跳转”选项与服务器层规则功能重复,保留一处即可。
此阶段常见的真实报错有两类,注意它们与 301 循环表现相似但成因不同:
AH00124: Request exceeded the limit of 10 internal redirects due to probable
configuration error. Use 'LimitInternalRecursion' to increase the limit if necessary.
rewrite or internal redirection cycle while internally redirecting to "/index.php",
client: 203.0.113.10, server: example.com, request: "GET / HTTP/1.1"
前者是 Apache 内部重写次数超限,后者是 Nginx 的 try_files 或 rewrite 找不到落点。二者都说明规则链存在自我引用,而不是客户端在跳转。排查时先把所有跳转规则注释掉,确认站点能正常返回 200,再逐条恢复,一次只加一条。
配置方案对比:跳转应该放在哪一层
不同判断依据在反代场景下的可靠性差异很大,选错变量是循环的根源。
| 判断方式 | Nginx 变量 | 经过 CDN/反代后是否可靠 | 说明 |
|---|---|---|---|
| 监听端口 | $server_port = 80 |
可靠 | CDN 回源 80 端口时会误跳 |
| 连接协议 | $scheme |
不可靠 | 反代后恒为 http,必循环 |
| 标准转发头 | $http_x_forwarded_proto |
可靠 | 需 CDN/反代显式传递 |
| Cloudflare 专用头 | $http_cf_visitor |
可靠 | 仅 Cloudflare 生效,需解析 JSON |
| 应用层配置 | siteurl/home |
取决于环境 | 必须与反代协议一致 |
跳转位置的取舍同样有明确结论:
| 方案 | 跳转执行点 | 优点 | 风险 |
|---|---|---|---|
| CDN 边缘跳转 | CDN(Always Use HTTPS) | 源站零配置,延迟最低 | 依赖 CDN,回源协议必须为 HTTPS |
| 源站跳转 | Nginx/Apache | 不依赖 CDN,迁移方便 | 必须用 X-Forwarded-Proto 判断 |
| 应用层跳转 | WordPress 插件 | 配置简单 | 与服务器规则叠加易循环 |
| HSTS 强制 | 浏览器 | 后续请求不再走 HTTP | 配置错误时难以回滚 |
生产环境推荐组合:CDN 开启 Always Use HTTPS 做第一层跳转,源站仅监听 443 并用 X-Forwarded-Proto 兜底,应用层关闭所有跳转插件。HSTS 用 max-age=31536000; includeSubDomains 起步,确认全站 HTTPS 无误后再考虑加入 preload 列表,否则回滚周期会非常痛苦。
常见错误排查(含真实报错)
1. curl: (47) Maximum (50) redirects followed:确认存在循环。加 --max-redirs 3 -v 逐跳查看请求头,重点看 X-Forwarded-Proto 是否被 CDN 正确传递。
2. 浏览器报 ERR_TOO_MANY_REDIRECTS,但 curl 只有一次 301:浏览器缓存了 301 或 HSTS 记录。用无痕窗口复测,并在 chrome://net-internals/#hsts 的 Delete domain security policies 中删除该域名。
3. Cloudflare 525 SSL handshake failed:源站 443 端口没有监听,或防火墙只放行了 CDN 回源 IP 段。用 ss -lntp | grep 443 确认监听状态。
4. Cloudflare 526 Invalid SSL certificate:源站证书过期、自签或域名不匹配。用 openssl s_client -connect example.com:443 -servername example.com 检查证书链是否完整,注意必须带 -servername,否则 SNI 站点会拿到默认证书。
5. ERR_SSL_PROTOCOL_ERROR:源站只开了 TLS 1.0/1.1 而 CDN 要求 TLS 1.2 以上,或 443 端口被非 TLS 服务占用。检查 ssl_protocols TLSv1.2 TLSv1.3;。
6. AH00124 与 Nginx rewrite cycle:内部重写循环,与 301 无关。检查 try_files 的最后一个参数是否指向真实存在的文件,以及 index.php 是否被 location 规则再次拦截。
7. 页面能打开但资源加载失败,控制台报 Mixed Content:跳转已修复,但页面里仍有硬编码的 http:// 资源。用 curl -s https://example.com | grep -o 'http://[^"''']*' 快速扫出残留链接。
效果验证与回归清单
修复后按顺序执行以下验证,全部通过才算闭环:
# 1. 跳转次数应为 1,最终落点 200
curl -o /dev/null -sIL -w 'redirects=%{num_redirects} final=%{url_effective} code=%{http_code}n'
--max-redirs 5 http://example.com
# 2. 确认 HSTS 与最终协议
curl -sI https://example.com | grep -iE 'strict-transport-security|location|server'
# 3. 确认证书有效期与签发者
openssl s_client -connect example.com:443 -servername example.com /dev/null
| openssl x509 -noout -subject -issuer -dates
# 4. 确认 www 与非 www 行为一致
curl -o /dev/null -sIL -w '%{url_effective} %{http_code}n' --max-redirs 5 http://www.example.com
期望结果:第 1 条输出 redirects=1、final=https://example.com/、code=200;第 2 条能看到 strict-transport-security;第 3 条 notAfter 在有效期内且与当前时间差距小于证书周期(Let’s Encrypt 90 天、商业证书 398 天);第 4 条最终落在同一个规范域名上。
| 检查项 | 期望值 | 不通过时的排查方向 |
|---|---|---|
| HTTP 跳转次数 | 1 次 | CDN 与源站重复跳转 |
| HTTPS 直接访问 | 200,无 Location | 应用层 siteurl 不一致 |
| 回源协议 | HTTPS | CDN 加密模式仍为 Flexible |
| 证书剩余天数 | 大于 15 天 | 自动续期未配置 |
| HSTS 头 | 存在且 max-age ≥ 15552000 | 未开启或仅源站返回被 CDN 覆盖 |
| www / 非 www | 收敛到同一域名 | 两条 server 块互相跳 |
最后做一次回归:用手机 4G 网络(不走本地 DNS 缓存)、无痕窗口、curl --resolve 指定源站 IP 三种方式各访问一次,并观察 24 小时内 Nginx 日志中 301 的数量是否归零。若仍有大量 301 在 443 端口上产生,说明应用层还在跳,需要继续清理插件与伪静态规则。
常见问题
大概率是 CDN 加密模式仍为 Flexible,CDN 到源站这一段走的是 HTTP。源站看到 http 就跳 https,CDN 又用 http 回源,形成闭环。把模式改成 Full (strict),并确认源站证书域名匹配、未过期即可。
经过 CDN 或反向代理后,源站与代理之间的连接是 HTTP,$scheme 恒为 http,无法反映客户端真实协议。应改用 $http_x_forwarded_proto,并用 map 指令归一化后再判断,同时确认代理层确实传递了该请求头。
浏览器会缓存 301 与 HSTS 策略。用无痕窗口复测,并在 chrome://net-internals/#hsts 中删除该域名的安全策略记录。另外检查是否有 Service Worker 拦截请求,可在 DevTools 的 Application 面板中注销后重试。
推荐在 CDN 边缘或 Nginx 层做,应用层只保留一处。同时把 siteurl 与 home 统一为 https 规范域名,并关闭 Really Simple SSL 等插件的 .htaccess 跳转选项,避免与服务器规则重复叠加导致循环。
可以,但有延迟。浏览器会按 max-age 缓存 HSTS 策略,期间无法用 HTTP 访问。建议先用 max-age=300 短周期验证,确认全站 HTTPS 与证书续期正常后再逐步提高到 31536000,不要一上来就提交 preload 列表。
公开信任的 TLS 证书单张最长 398 天,Let’s Encrypt 为 90 天。证书过期本身不会造成重定向循环,但会让回源 HTTPS 失败,报错变成 526 或 ERR_SSL_PROTOCOL_ERROR,容易与循环问题混淆,因此排查时应同时检查 notAfter。