Apache APISIX中实现HTTP 302重定向URL的动态替换方案

在实际生产环境中，我们经常遇到需要修改HTTP响应头中Location字段的需求。本文将以一个典型场景为例，详细介绍如何在Apache APISIX中实现302重定向URL的动态替换。

场景分析

假设我们有一个WordPress站点，当用户访问/wp-admin/路径时：

1. 未登录用户会收到302重定向响应，Location头指向http://blog.xxx.com.cn:19080/wp-login.php
2. 已登录用户则直接进入管理界面

现在需要将重定向URL中的协议和端口从http://blog.xxx.com.cn:19080修改为https://blog.xxx.com.cn:19443，同时保持原有的业务逻辑不变。

技术挑战

直接使用response-rewrite插件设置Location头会导致所有访问都被重定向，破坏了原有的登录状态判断逻辑。而redirect插件虽然可以创建新的重定向，但无法修改已有的重定向响应。

解决方案

方案一：条件式响应头重写

利用response-rewrite插件的vars条件匹配功能，可以精确控制重写行为：

{
  "uri": "/wp-admin/",
  "plugins": {
    "response-rewrite": {
      "headers": {
        "set": {
          "Location": "https://blog.xxx.com.cn:19443/wp-login.php"
        }
      },
      "vars": [
        ["status", "==", 302]
      ]
    }
  }
}

这个配置的关键点在于：

1. 只对302状态码的响应进行修改
2. 保留了原始路径/wp-login.php
3. 仅修改协议和端口部分

方案二：高级变量处理

对于更复杂的需求，可以使用APISIX的变量系统实现动态替换：

{
  "uri": "/wp-admin/",
  "vars": [
    ["status", "==", 302]
  ],
  "plugins": {
    "response-rewrite": {
      "headers": {
        "set": {
          "Location": "https://blog.xxx.com.cn:19443$uri"
        }
      }
    }
  }
}

这种方案可以：

1. 自动保留原始URI路径
2. 只对特定状态码的响应生效
3. 支持更灵活的重写规则

实现原理

APISIX的响应重写机制基于OpenResty的header_filter阶段实现，具有以下特点：

1. 在Nginx处理完上游响应后执行
2. 可以访问完整的响应头和状态码
3. 支持基于条件的精细化控制

注意事项

1. 确保重定向后的地址是可访问的
2. 考虑HTTPS证书的有效性
3. 测试各种边界条件（如带查询参数的URL）
4. 监控重定向循环的可能性

通过以上方案，我们可以在不破坏原有业务逻辑的前提下，实现HTTP重定向URL的安全升级和定制化修改。这种技术不仅适用于WordPress场景，也可广泛应用于各种需要修改重定向行为的Web应用中。