gae标准环境要求go版本与runtime严格匹配，仅支持go119/go120/go121等指定runtime；main需提供监听:8080的http handler；app.yaml中handlers无效；环境变量和依赖须显式声明；无文件系统写权限。
Go 版本和 runtime 必须严格匹配 GAE 标准环境支持列表
Google App Engine 标准环境对 Go 有硬性版本限制，不是所有 Go 版本都能用。目前（2024 年）仅支持 go119、go120、go121（具体以 官方文档为准），且必须用对应 runtime 名称声明，不能写 go1.21 或 go-1.21。
常见错误现象：ERROR: (gcloud.app.deploy) INVALID_ARGUMENT: The request contains invalid arguments: [runtime]，或部署后服务返回 500 且日志里出现 Failed to find compatible runtime。
-
app.yaml中的runtime字段必须是小写、无点号、带go前缀的字符串，例如：runtime: go121 - 本地
go version输出需与runtime值语义一致；若用go1.21.6，就配go121，不是go1216 - 不支持自定义 Go 编译器或
GOROOT覆盖；GAE 构建阶段会用自己的 Go 环境重新编译
main.go 必须暴露 HTTP handler 且监听 :8080
GAE 标准环境不接受任意端口绑定，也不允许后台 goroutine 接管生命周期。它只认一个入口：全局变量 http.DefaultServeMux 或显式传入的 http.Handler，且必须监听 :8080（即使代码里写 localhost:8080 或 0.0.0.0:8080，GAE 也会重定向流量到该端口）。
常见错误现象：部署成功但访问返回 502 Bad Gateway，或日志中反复出现 Connection refused；本地能跑，GAE 上没响应。
- 不要调用
http.ListenAndServe—— GAE 已为你启动 server，你只需提供 handler - 主包里必须有
func main()，且至少注册一个路由，例如：http.HandleFunc("/", handler) - 若用
http.ServeMux自定义 mux，需确保它被赋值给http.DefaultServeMux，或通过appengine.Main()（旧 SDK）——但标准环境已弃用该函数，纯 Go 模式下直接写 handler 即可
app.yaml 中的 handlers 配置在标准环境中基本无效
标准环境（Standard Environment）的 Go 运行时自动接管所有路径，app.yaml 中的 handlers 列表会被忽略。你写 - url: /api/.* 或 - static_files 全都不起作用。这不是 bug，是设计如此。
常见错误现象：静态文件 404、API 路由不生效、误以为能做路径重写——其实全靠 Go 代码自己处理。
- 删掉
handlers块，只保留runtime、service（可选）、env_variables（可选）等必要字段 - 静态资源要嵌入二进制或托管到 Cloud Storage；前端路由需在 Go 中统一 fallback，例如用
http.FileServer+http.StripPrefix - 想用路径规则？只能在 Go 代码里用
http.ServeMux或第三方 router（如chi）实现
环境变量和依赖必须通过 app.yaml 和 go.mod 显式声明
GAE 不读取本地 .env 文件，也不自动 vendor 第三方包。所有环境变量得写进 app.yaml 的 env_variables，所有依赖必须出现在 go.mod 里且能被 go build 正常解析。
常见错误现象：运行时报 module not found、undefined: os.Getenv（其实是变量没设）、或连接数据库失败（因 DATABASE_URL 没传进去）。
-
env_variables是顶层字段，缩进必须对齐，值要用引号包裹字符串，例如：DB_HOST: "my-db-host" - 不要在
app.yaml里写GO111MODULE=on—— GAE 默认启用模块模式，加了反而可能干扰构建 - 如果用了 cgo（比如
net包某些底层行为），标准环境默认禁用 cgo；需加CGO_ENABLED=0到env_variables，否则构建失败
最易被忽略的是：GAE 标准环境没有文件系统写权限，os.TempDir() 返回的路径不可写，os.Create 会失败；所有 I/O 必须走 Cloud Storage、Datastore 或内存缓存。这点不提前检查，上线后日志里只会看到空 panic。
