Google App Engine dispatch.yaml路由异常：/api/*请求未指向指定服务

问题描述 #

在Google App Engine（GAE）环境中，已通过dispatch.yaml配置路由规则，期望将所有/api/*开头的请求路由至server API服务，其余请求路由至default前端服务，但实际所有请求均被default服务捕获：

• /api/*端点请求由default服务处理，server服务的API路由未触发
• 访问server服务的专属域名时，返回default服务的前端内容而非预期的健康信息

已确认：server服务部署成功且可正常连接数据库，GAE日志无服务错误，dispatch.yaml已重新部署。

相关配置 #

dispatch.yaml配置：

dispatch:
  - url: "*/api/*"
    service: server
  - url: "*/*"
    service: default

排查方向 #

1. 验证dispatch.yaml的规则语法与优先级 #

• GAE路由规则按从上到下顺序匹配，当前规则顺序正确，但需检查通配符格式：
  • 确认是否应为/api/*（仅匹配默认域名下的路径）而非*/api/*（匹配所有域名下的路径），根据实际域名使用场景调整
  • 检查YAML语法：确保缩进为2个空格，引号使用规范，无语法错误

2. 确认dispatch.yaml的部署状态 #

• 必须单独部署路由规则，执行命令：gcloud app deploy dispatch.yaml
• 登录GAE控制台，进入路由页面，确认配置的规则已显示在生效列表中

3. 核对server服务的配置一致性 #

• 检查server.yaml：必须包含service: server字段，确保与dispatch.yaml中指定的服务名完全一致
• 验证服务入口配置：确认entrypoint指令正确指向Express启动文件（如entrypoint: node server.js），确保服务能正常处理HTTP请求

4. 测试server服务的直接可用性 #

• 访问server服务专属域名：https://server-dot-[你的项目ID].appspot.com/[健康检查端点]
  • 若返回默认服务内容：说明server服务部署存在问题（如服务名错误、部署未成功），需重新部署server服务
  • 若返回预期健康信息：说明server服务正常，问题出在路由规则的匹配或部署

5. 检查GAE环境类型适配性 #

• 若使用灵活环境：确认server服务已启用HTTP负载均衡，端口配置正确（灵活环境需确保服务监听指定端口）
• 若使用标准环境：确认服务运行时配置与dispatch规则兼容（无需额外端口配置）

解决建议 #

1. 修正路由规则：将dispatch.yaml中的规则调整为更精准的前缀匹配，若仅使用默认GAE域名，可修改为：

   dispatch:
     - url: "/api/*"
       service: server
     - url: "/*"
       service: default
   

2. 重新部署路由规则：执行gcloud app deploy dispatch.yaml，确认部署日志显示Successfully deployed dispatch.yaml
3. 重新部署server服务：进入server服务代码目录，执行gcloud app deploy，确保服务名与配置完全一致
4. 验证路由生效：用curl测试/api/*端点，查看GAE日志确认请求是否路由至server服务
5. 排查前端路由干扰：若default服务是SPA应用（如React/Vue），在client.yaml中配置static_files规则，排除/api/*路径被前端路由捕获

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