Google App Engine上下文路径失效及HTTPS重定向异常问题排查

针对你遇到的两个问题，咱们一一拆解：

1. HTTP未自动重定向到HTTPS（secure: always无效） #

这是因为App Engine Flexible环境并不支持handlers中的secure: always配置——这个参数只在Standard环境中生效。要在Flex环境下实现HTTP到HTTPS的强制重定向，你需要在app.yaml的顶层添加重定向配置：

runtime: nodejs
env: flex
# 添加这一行启用HTTPS永久重定向（临时重定向可改为302）
redirect_http_response_code: 301
resources:
  cpu: 1
  memory_gb: 1
  disk_size_gb: 20
# 后续handlers配置需结合第二个问题调整

配置完成后，所有HTTP请求都会自动跳转到对应的HTTPS地址。

2. /api/test返回404，/api前缀被忽略 #

这个问题出在handlers的URL匹配规则上：

• 你当前的第一个handler配置是url: /api，它只会精确匹配/api这一个路径，无法覆盖/api/test这类子路径；
• 当请求/api/test时，它会匹配到第二个handler（url: /），而这个handler设置了static_dir: public——App Engine会优先在public目录中查找资源，找不到就直接返回404，不会转发到你的Node.js应用；
• 而/test能正常访问，是因为该请求也匹配第二个handler，但public目录中没有对应静态资源，App Engine默认将未匹配到静态资源的请求转发到了你的应用（这个行为可能因环境配置略有差异）。

修复方案：调整handlers的URL匹配规则 #

修改handlers配置，让所有以/api开头的请求都转发到应用，同时确保静态资源和其他动态路由正常工作：

handlers:
# 匹配所有/api开头的请求，转发到Node.js应用
- url: /api/*
  secure: always
# 根路径返回public目录下的index.html（适配单页应用场景）
- url: /
  secure: always
  static_files: public/index.html
  upload: public/index.html
# 匹配所有带后缀的静态资源（如.css/.js/.png等）
- url: /(.*\..*)
  secure: always
  static_files: public/\1
  upload: public/(.*\..*)
# 匹配其他所有请求，转发到应用（处理/test这类动态路由）
- url: /.*
  secure: always

这样配置后：

• 所有/api/xxx的请求都会被转发到你的Node.js应用，/api/test就能被正确处理；
• 静态资源（如/css/style.css）会从public目录返回；
• 根路径返回index.html，其他动态路由（如/test）也会正常转发到应用。

补充说明 #

在Flex环境中，script字段可以省略——只要不设置static_dir或static_files，App Engine就会自动把请求转发到你的Node.js应用服务器。

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