在 apache 中临时更换 api 接口地址，最直接且高效的方法是使用 rewriterule 配合 r=302 标志进行重定向。通过配置 .htaccess 文件或虚拟主机配置，匹配旧的 api 路径并将其指向新的 url，apache 会在响应头中返回 302 found 状态码，客户端浏览器或调用方会自动跟随新地址请求。这种方式无需修改后端代码，配置即时生效，且因为是临时重定向，搜索引擎和缓存不会永久记录旧地址，非常适合过渡期使用。
如何配置 .htaccess 实现特定路径的 302 跳转
要在项目中快速应用这一策略，只需在网站根目录或 API 所在子目录下的 .htaccess 文件中添加重写规则。核心逻辑是启用 mod_rewrite，设置 RewriteEngine On，然后使用 RewriteRule 指定正则表达式匹配旧路径，并指向新地址，最后加上 R=302,L 标志。其中 R=302 明确指示发送临时重定向，L 表示这是最后一条规则，匹配成功后立即停止处理后续规则，避免不必要的性能损耗。
<IfModule mod_rewrite.c>
RewriteEngine On
# 匹配旧 API 路径 /api/v1/old-endpoint
RewriteRule ^api/v1/old-endpoint$ https://new-domain.com/api/v2/new-endpoint [R=302,L]
</IfModule>
上述配置假设旧接口为 /api/v1/old-endpoint，新接口位于完全不同的域名 https://new-domain.com。如果新旧接口在同一域名下仅路径不同，例如从 /api/old 跳转到 /api/new，则目标地址只需写相对路径 /api/new 即可。测试时可以使用 curl -I http://localhost/api/v1/old-endpoint 命令，观察返回的 HTTP/1.1 302 Found 以及 Location: ... 头部字段，确认重定向是否按预期工作。
如何处理带查询参数的复杂重定向场景
当旧 API 地址包含动态查询参数（Query String）且需要保留这些参数传递给新接口时，简单的 RewriteRule 可能不够用，因为默认情况下查询参数不会自动附加到重定向目标。此时需要结合 %{QUERY_STRING} 变量或使用 [QSA]（Query String Append）标志。如果新接口完全兼容旧接口的参数结构，使用 [QSA,R=302,L] 是最简便的做法，它会将原始请求中的参数追加到新 URL 后面。若参数结构发生变动，则需要更精细的正则捕获和替换逻辑。
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
<IfModule mod_rewrite.c>
RewriteEngine On
# 匹配 /api/search?q=test&lang=zh
# 将 q 和 lang 参数捕获并传递到新接口
RewriteRule ^api/search$ https://new-domain.com/api/v2/search?%{QUERY_STRING} [R=302,QSA,L]
</IfModule>
在上面的示例中，%{QUERY_STRING} 会原样附加到新 URL 后，而 [QSA] 标志确保如果新 URL 已经带有参数（如示例中的 ?q=...），旧参数会被追加而不是覆盖。这种配置特别适用于重构期间，前端调用方尚未完全切换，但后端已部署在新地址的情况。需要注意的是，如果新接口对参数格式有严格要求，建议在服务器端先做校验或转换，或者在前端逐步适配新接口，以减少因参数丢失导致的错误。
重定向循环与缓存问题的排查方法
在实施临时重定向时，最常见的故障是陷入重定向循环（Redirect Loop）或客户端缓存了错误的 302 状态导致后续请求依然失败。循环通常发生在新旧地址互相指向对方，或者正则表达式匹配范围过大导致自身被重定向。例如，如果规则写成 RewriteRule ^api/.*$ /api/new [R=302,L]，而 /api/new 也匹配该规则，就会形成死循环。排查此类问题应检查 ErrorLog 中是否出现 “Maximum redirect count exceeded” 警告，并使用 curl -v 查看完整的请求链。
另一个关键点是浏览器的缓存行为。虽然 302 是临时重定向，但现代浏览器通常会缓存 302 响应以提高性能。如果在调试过程中修改了重定向规则，客户端可能仍然执行旧的跳转。解决此问题的方法是清除浏览器缓存，或在开发环境中使用隐私模式测试。对于服务端调用，确保每次请求都重新解析 DNS 和路由配置。此外，如果使用了 CDN 或反向代理，它们也可能缓存重定向响应，需要在 CDN 控制台刷新相关 URL 的缓存，以确保最新配置生效。
