Kubernetes Nginx Ingress重写URL时编解码异常如何解决

问题复现 #

• 原始请求URL：http://host/a%7b%7c
• 第一次配置（使用官方rewrite-target注解）：

  nginx.ingress.kubernetes.io/rewrite-target: dev/$1
  

  转发后URL变为host/dev/a|b|c，Ingress自动对编码字符做了解码，不符合预期。
• 第二次配置（自定义server-snippet写两层rewrite）：

  nginx.ingress.kubernetes.io/server-snippet: |
     rewrite ^ $request_uri;
     rewrite /(.*) /dev/$1;
  

  转发后URL变为host/dev/a%257b%257c，出现二次编码问题（%被转码为%25），同样不符合预期。
• 预期结果：重写后URL完全保留原始编码，最终为host/dev/a%7b%7c。

根因说明 #

• 默认rewrite-target注解底层依赖ngx_http_rewrite_module的捕获组传参，捕获组提取到的路径值是Nginx自动解码后的结果，所以最终转发的路径会丢失原始编码。
• 两层rewrite的写法会触发Nginx内部的URI重解析流程，Nginx会对重写后的URI做规范化编码，原始路径里的%会被编码为%25，导致二次编码问题。

可行解决方案 #

优先选择方案1，无额外依赖；如果方案1在部分版本Ingress下存在兼容问题，使用方案2。

方案1：单层rewrite + break 绕过URI重解析 #

删除原有rewrite-target和错误的server-snippet配置，添加如下注解：

nginx.ingress.kubernetes.io/configuration-snippet: |
  # 跳过已经带/dev前缀的请求，避免循环重写
  rewrite ^/dev/  /dev/ last;
  # 直接拼接原始未解码$request_uri，break终止后续rewrite流程，不触发URI重解析
  rewrite ^ /dev$request_uri break;

配置逻辑说明：

• 直接使用全局变量$request_uri，该变量存储的是客户端发来的完全未解码的原始请求URI（包含路径和Query参数），不会被Nginx自动解码。
• 拼接前缀后用break终止rewrite循环，不会触发Nginx重新匹配location和URI规范化流程，避免二次编码。

方案2：Lua脚本精确控制URI重写（100%兼容） #

如果使用的Nginx Ingress版本对rewrite的处理逻辑有差异，可使用Lua脚本直接操作请求URI，完全绕过rewrite模块的自动编解码逻辑（默认安装的Nginx Ingress都内置Lua模块，无需额外安装）：

nginx.ingress.kubernetes.io/configuration-snippet: |
  access_by_lua_block {
    local original_uri = ngx.var.request_uri
    -- 拼接/dev前缀，不对原始URI做任何编解码处理
    local target_uri = "/dev" .. original_uri
    -- 第二个参数传false，禁止URI重跳转和重新解析，直接透传编码
    ngx.req.set_uri(target_uri, false)
  }

该方案直接在请求接入阶段修改转发URI，不会经过rewrite模块的任何编解码处理，完全保留客户端请求的原始编码格式，Query参数也会自动透传。

注意事项 #

• 配置时需要删除原有的nginx.ingress.kubernetes.io/rewrite-target注解，避免规则冲突。
• 两种方案都不会修改原始请求的Query参数，参数会随路径一起透传给后端服务。

内容的提问来源于stack exchange，提问作者孔繁超