如何在Cloud Endpoints多版本API中规避CORS与x-google-endpoints限制？

问题本质 #

你碰到的错误是因为同一个Endpoints网关下，多个OpenAPI spec重复定义了x-google-endpoints的同名条目——Endpoints不允许重复配置全局网关属性。而之前Cloud Run的CORS配置无效，是因为Endpoints直接拦截了OPTIONS预请求，根本没转发到你的服务。

你的三个问题解答 #

1. 能不能不用x-google-endpoints处理CORS？ #

可以，但需要确保Endpoints要么把OPTIONS请求转发到Cloud Run，要么在spec里配置全局OPTIONS路由响应CORS头。不过用x-google-endpoints的allowCors是最省心的，只要避免重复配置就行。

2. 能不能在Cloud Run里处理CORS，不用Endpoints配置？ #

可以，但前提是Endpoints会把OPTIONS预请求转发到你的Cloud Run服务。默认情况下，如果Endpoints没配置对应的OPTIONS路由，会直接拒绝请求，你的Cloud Run代码根本没机会执行。所以得在spec里给每个路径加OPTIONS路由，或者配全局OPTIONS路由。

3. 有没有其他简单方法？ #

有两个最直接的方案：

方案一：合并两个API版本到同一个OpenAPI文件（推荐） #

把V1和V2的API定义合并成一个spec，用路径前缀区分版本，只保留一份x-google-endpoints配置。示例：

swagger: '2.0'
host: gateway-url
x-google-endpoints:
  - name: gateway-url
    allowCors: true
info:
  title: Multi-version API
  description: API包含V1和V2版本
  version: 1.0.0
schemes:
  - https
produces:
  - application/json
consumes:
  - application/json

paths:
  # V1接口
  /v1/your-resource:
    get:
      summary: 获取V1资源
      x-google-backend:
        address: https://your-cloud-run-service
      responses:
        '200':
          description: 请求成功

  # V2接口
  /v2/your-resource:
    get:
      summary: 获取V2资源
      x-google-backend:
        address: https://your-cloud-run-service
      responses:
        '200':
          description: 请求成功

一次部署搞定，既不会有重复配置错误，CORS也全局生效。

方案二：分开部署时只配置一次x-google-endpoints #

如果必须保留两个独立的spec文件：

1. 部署第一个版本（比如V1）时，保留x-google-endpoints配置并开启allowCors: true。
2. 部署第二个版本（V2）时，完全删掉x-google-endpoints配置。
   Endpoints网关的CORS是全局配置，一旦通过第一个spec设置后，后续部署的spec不需要重复配置，网关会保持CORS开启状态，两个版本的API都能正常工作。

让Cloud Run处理CORS的正确姿势 #

如果坚持要在Cloud Run里处理CORS，得在OpenAPI spec里给所有路径加OPTIONS路由，确保Endpoints把预请求转发到Cloud Run。示例：

paths:
  /v1/your-resource:
    options:
      summary: V1接口CORS预请求
      operationId: cors-v1
      x-google-backend:
        address: https://your-cloud-run-service
      responses:
        '204':
          description: 无内容
    get:
      # 你的V1 GET接口配置...

  /v2/your-resource:
    options:
      summary: V2接口CORS预请求
      operationId: cors-v2
      x-google-backend:
        address: https://your-cloud-run-service
      responses:
        '204':
          description: 无内容
    get:
      # 你的V2 GET接口配置...

同时要确保Cloud Run代码里的CORS中间件是全局注册的（比如用app.use(cors(corsOptions))，而不是只在某个路由上注册），这样所有请求都会经过CORS处理。

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