API网关自动为后端hostname加backend-cluster前缀导致503故障求助

该503错误的直接原因是API网关错误将你配置的公网后端识别为GCP内部托管服务，触发内部服务命名规则，给原域名自动添加backend-cluster-前缀，导致请求SNI和后端TLS证书的域名不匹配，触发证书验证失败。

核心诱因 #

• Service Directory服务发现规则误匹配：如果你的GCP项目开启了Service Directory服务，且存在和dev.equipment.example.com匹配的服务注册规则，API网关会默认将该域名识别为内部服务，自动添加前缀拼接为内部解析域名，不会直接对公网域名发起请求。
• GKE集群服务名冲突：如果当前GCP项目在网关所属的europe-west2区域部署了GKE集群，且集群内存在和dev.equipment前缀匹配的服务名，API网关的内部DNS解析逻辑会错误将公网后端识别为集群内部服务，自动添加前缀走集群内部路由。
• x-google-backend参数配置缺失：对接公网第三方后端时，需要显式配置disable_auth: true参数。未配置该参数时，网关会默认尝试将后端识别为GCP托管服务（Cloud Run、GKE服务等），触发内部服务的前缀拼接逻辑。

修复方案 #

• 调整OpenAPI配置，在x-google-backend节点下新增disable_auth: true和hostname_override参数，强制网关对公网域名发起请求：

x-google-backend:
  address: https://dev.equipment.example.com/api/v1/XXXXXXXX
  protocol: http/1.1
  path_translation: APPEND_PATH_TO_ADDRESS
  disable_auth: true
  hostname_override: "dev.equipment.example.com"

• 检查当前GCP项目的Service Directory配置，删除和dev.equipment.example.com匹配的错误服务注册规则。
• 检查同区域GKE集群的服务名称，避免和公网域名前缀产生冲突。

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