GCP API Gateway代理非GCP端点配置失败求助

问题分析 #

你遇到的POST object expects Content-Type multipart/form-data错误，核心原因是Swagger配置存在格式问题，加上API Gateway代理外部服务时的默认行为导致请求头处理异常。原配置中basePath使用了数组格式（Swagger 2.0要求为字符串），这会导致路径解析错误，进而触发错误的Content-Type校验逻辑。

修正后的Swagger配置 #

以下是可正常代理外部URL的配置示例，关键修改点已标注：

swagger: "2.0"
info:
  title: migration-api
  description: API for migration sql
  version: 1.2.3
schemes:
  - https
consumes:
  - application/json
produces:
  - application/json
basePath: /api/track  # 修正：改为字符串格式，原配置是数组
paths:
  /track:
    post:
      operationId: track
      # 明确指定请求体类型，强化Content-Type约束
      parameters:
        - name: body
          in: body
          required: true
          schema:
            type: object
            additionalProperties: true
      x-google-backend:
        address: https://notgoogle.com/
        path_translation: CONSTANT_ADDRESS
        preserveHost: true  # 新增：保留请求头中的Host信息，确保外部服务正确接收请求
      responses:
        200:
          description: Success

其他备选方案 #

如果上述配置仍无法解决问题，可以通过Cloud Functions中转实现代理：

• 让API Gateway指向你的Cloud Functions函数
• 在Cloud Functions中编写代码，将请求转发到目标外部URL，同时手动处理请求头和请求体，确保Content-Type等参数正确传递
• 这种方式灵活性更高，能自定义处理各种请求细节，避免API Gateway的默认行为限制

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