排查 apache mod_rewrite 302 循环跳转,核心是检查重写规则是否导致目标 url 再次匹配到触发重写的条件,从而形成死循环。解决思路包括在规则中排除已处理过的请求(如通过环境变量标记)、使用 [l] 标志终止后续规则匹配,或调整 rewritecond 以精确限定触发范围。

如何识别当前请求是否陷入了重写循环
当浏览器收到连续的 302 响应且地址栏 URL 不变或反复变化时,通常意味着服务器端发生了循环。可以通过查看 Apache 错误日志中的 RewriteMap 或内部重计数来确认。Apache 默认限制内部重定向次数为 10 次,超过后会返回 500 错误并提示 "Maximum number of internal redirects reached"。若未触发此上限,说明规则逻辑允许无限递归,需手动干预。

<VirtualHost *:80>
ServerName example.com
DocumentRoot /var/www/html
<Directory /var/www/html>
Options -Indexes
AllowOverride All
Require all granted
</Directory>
RewriteEngine On
# 示例:将非 HTTPS 流量重定向到 HTTPS
RewriteCond %{HTTPS} off
RewriteRule ^(.*)$ https://%{HTTP_HOST}%{REQUEST_URI} [L,R=301]
# 错误示范:如果上述规则配置不当,可能导致循环
# 例如,如果后端代理修改了 HTTPS 头但未正确传递,可能再次触发 off 判断
</VirtualHost>
预期结果:访问 http://example.com 应被永久重定向(301)至 https://example.com,且不再重复跳转。若出现 302 循环,检查 %{HTTPS} 变量在代理环境下的实际值。
通过Apache Tika Server REST API从1400多种文件格式中提取文本和元数据。处理PDF、DOCX、PPTX、电子邮件归档以及带有MIME类型检测的嵌入式文档提取。
如何通过环境变量防止规则重复匹配
防止循环最有效的方法是使用环境变量作为“已处理”标记。在第一次匹配并重写后,设置一个环境变量(如 REDIRECT_STATUS 或自定义变量),并在后续的 RewriteCond 中排除该状态。这样,即使 URL 再次经过重写引擎,也不会再次触发重定向规则。

# 修正后的 .htaccess 示例
RewriteEngine On
# 仅当不是重定向请求时才进行 HTTPS 强制跳转
RewriteCond %{ENV:REDIRECT_STATUS} ^$
RewriteCond %{HTTPS} off
RewriteRule ^(.*)$ https://%{HTTP_HOST}%{REQUEST_URI} [L,R=301]
# 其他业务规则...
RewriteRule ^old-page$ /new-page [L,R=301]
预期结果:REDIRECT_STATUS 在首次请求时为空,触发 HTTPS 跳转;跳转后,Apache 内部重新发起请求,此时 REDIRECT_STATUS 被设置为 301,第二个条件失败,规则不再执行,从而避免循环。
基于 REDIRECT_STATUS 变量的具体行为分析
在 Apache 的内部重定向机制中,每次内部重传都会更新 REDIRECT_STATUS 环境变量。初始请求时,该变量为空字符串。一旦触发了带有 R 标志的重写规则,Apache 会在内部重新处理请求,并将 REDIRECT_STATUS 设置为对应的 HTTP 状态码(如 301 或 302)。因此,在规则条件中加入 RewriteCond %{ENV:REDIRECT_STATUS} ^$ 可以确保规则只在原始请求时生效一次。这是解决因条件判断过于宽泛而导致的 302 循环的标准做法。

















