Apache APISIX 代理 HDFS WebUI 的 302 重定向问题解决方案

问题背景

在使用 Apache APISIX 代理 Hadoop HDFS 的 WebUI 时，开发人员经常会遇到 302 重定向问题。具体表现为当通过 APISIX 访问 HDFS 的 WebUI 时，服务端会返回 302 状态码并重定向到 index.html 页面，导致代理无法正常工作。

问题分析

HDFS 的 NameNode WebUI 默认运行在 9870 端口，当用户访问根路径时，服务端会主动返回 302 重定向到 /index.html。这种设计在直接访问时没有问题，但在通过 APISIX 代理时会导致代理链断裂。

解决方案

方案一：使用代理重写插件

可以通过 APISIX 的 proxy-rewrite 插件来处理路径重写问题：

apiVersion: apisix.apache.org/v2
kind: ApisixRoute
metadata:
  name: hdfs-proxy-route
spec:
  http:
    - name: hdfs-proxy
      match:
        hosts:
          - example.com
        paths:
          - /hdfs/*
      backends:
        - serviceName: namenode-service
          servicePort: 9870
      plugins:
        - name: proxy-rewrite
          enable: true
          config:
            regex_uri: ["^/hdfs/(.*)", "/$1"]

方案二：处理重定向响应

对于已经发生的 302 重定向，可以使用 response-rewrite 插件来修正重定向地址：

plugins:
  - name: response-rewrite
    enable: true
    config:
      headers:
        set:
          Location: "http://example.com/hdfs/index.html"
      vars:
        - ["status", "==", 302]

方案三：添加根路径路由

为根路径单独配置一条路由规则，直接代理到 index.html：

- name: hdfs-root
  match:
    hosts:
      - example.com
    paths:
      - /hdfs
  backends:
    - serviceName: namenode-service
      servicePort: 9870
  plugins:
    - name: proxy-rewrite
      enable: true
      config:
        uri: "/index.html"

健康检查配置

对于生产环境，建议配置主动健康检查以确保 NameNode 的高可用性：

apiVersion: apisix.apache.org/v2
kind: ApisixUpstream
metadata:
  name: namenode-upstream
spec:
  healthCheck:
    active:
      type: http
      httpPath: /isActive
      healthy:
        interval: 5
        httpStatuses:
          - 200
          - 302
      unhealthy:
        interval: 1
        httpFailures: 3

最佳实践

1. 对于静态资源路径，建议在 APISIX 中配置缓存策略，提高访问性能
2. 生产环境建议启用 HTTPS 加密传输
3. 可以结合 limit-req 插件对 HDFS WebUI 的访问进行限流
4. 考虑使用 authz-keycloak 等插件实现访问控制

通过以上配置，可以有效地解决 APISIX 代理 HDFS WebUI 时的 302 重定向问题，实现稳定可靠的访问服务。