GCP API Gateway路径参数被作为查询参数传递的问题如何解决

你遇到的路径参数未替换问题是GCP API Gateway的x-google-backend扩展默认配置导致的：默认使用CONSTANT_ADDRESS路径转换策略，该策略会将address字段值当做固定地址处理，不会解析替换地址中的路径占位符，反而会将原请求的路径参数转为查询参数附加到后端地址后，%7Bid_%7D就是占位符{id_}的URL编码结果。

修复方案 #

有两种常用实现方式，按需选择即可：

方案1：路径重写+动态路径拼接（推荐，适合同服务多路径统一配置） #

这种方式不需要为每个路径单独配置参数映射，适合同个后端服务有多个路径的场景，仅需要调整对应配置段：

paths:
  /service_a/match/{id_}:
    get:
      # 保留你原有的summary、description、operationId、parameters、responses配置不变
      x-google-backend:
        address: <cloud_run_url> # 仅填Cloud Run的根地址
        path_translation: APPEND_PATH_TO_ADDRESS # 开启路径拼接模式
        deadline: 60.0
      # 新增路径重写规则，去掉网关路径前缀/service_a
      x-google-path-rewrite:
        pattern: '/service_a/(.*)'
        replacement: '/$1'

配置生效后，网关会自动去掉请求路径的/service_a前缀，将剩下的部分拼接到Cloud Run根地址后，自动完成路径参数替换。

方案2：显式配置路径参数映射（适合单路径定制化配置） #

如果你不想修改原有后端地址的写法，直接在x-google-backend下添加参数映射规则即可：

x-google-backend:
  address: <cloud_run_url>/match/{id_}
  path_translation: CONSTANT_ADDRESS # 保持默认策略也可，显式声明更清晰
  deadline: 60.0
  # 新增参数映射，将请求路径中的id_参数绑定到后端地址的占位符
  parameters:
    - name: id_
      in: path
      value: $request.path.id_

如果后续新增其他路径参数，按相同格式在parameters数组下添加映射即可。

验证 #

修改配置后重新部署API网关，再次请求gateway_url/service_a/match/123就会被正确路由到cloud_run_url/match/123，原有的查询参数bool_first、bool_Second也会正常传递给后端服务。

内容的提问来源于stack exchange，提问作者Nissan