Google API Gateway双查询参数传递异常：仅识别首个参数

问题重现 #

原有Google Cloud Function通过API Gateway使用单个key查询参数认证正常，新增foo业务参数后出现两种异常：

• 执行 curl https://GATEWAY_URL/hello?key=API_KEY&foo=bar 返回500，Cloud Function日志显示未收到foo参数
• 执行 curl https://GATEWAY_URL/hello?foo=bar&key=API_KEY 返回未授权

核心原因 #

1. Shell命令解析问题：未用引号包裹URL时，&会被shell识别为后台执行符，导致curl实际只发送了第一个参数部分（比如第一个命令实际请求的是https://GATEWAY_URL/hello?key=API_KEY，foo=bar被当作独立后台命令执行）。
2. Gateway参数转发配置缺失：默认情况下，API Gateway不会自动将业务查询参数转发到后端Cloud Function，需要显式配置。

解决方案 #

步骤1：修正curl命令格式 #

用双引号包裹完整URL，避免shell截断参数：

curl "https://GATEWAY_URL/hello?key=API_KEY&foo=bar"

步骤2：更新API Gateway配置 #

修改openapi2-functions.yaml，在x-google-backend中添加参数转发配置，有两种可选方式：

方式一：全局转发路径与查询参数

设置path_translation: APPEND_PATH_TO_ADDRESS，让Gateway将请求的路径和查询参数附加到后端地址（认证用的key参数不会被转发，仅业务参数会被传递）：

x-google-backend:
  address: https://redacted.cloudfunctions.net/hello-world-1
  path_translation: APPEND_PATH_TO_ADDRESS

方式二：显式指定转发特定参数

使用query_parameters_transform明确转发foo参数，适合需要精确控制参数的场景：

x-google-backend:
  address: https://redacted.cloudfunctions.net/hello-world-1
  query_parameters_transform:
    add:
      - key: "foo"
        value: "$request.query.foo"

验证配置 #

更新配置后重新部署API Gateway，执行修正后的curl命令，确认Cloud Function能正常接收foo参数且认证通过。

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