如何在Google App Engine的app.yaml中读取配置的环境变量

一、app.yaml 格式必守规则 #

• 缩进规则：所有env_variables下的子配置必须使用2个空格缩进，禁止使用Tab符，也不能出现缩进层级错误。你当前贴出的app.yaml示例缩进看起来符合要求，但如果实际文件里有隐形缩进问题会直接导致配置不生效
• 特殊字符转义：如果环境变量值包含@、:、空格、换行等特殊字符，必须用英文双引号包裹，比如你的密码配置可以改为DB_PASS: "p@ssword"，避免YAML解析器识别异常
• 运行时版本兼容：go115属于官方已停止维护的老旧运行时版本，存在已知的环境变量解析bug，建议先升级到官方支持的稳定Go运行时（如go121）后重新部署测试

二、读取前必要排查步骤 #

• 不要用本地set命令验证变量：app.yaml中配置的环境变量只会注入到GAE实例的运行时环境中，本地终端执行set/export命令完全看不到。验证方式可以是在代码中添加日志打印os.Getenv("DB_USER")的返回值，部署后到Cloud Logging中查看对应日志即可
• 确认流量打到新部署版本：执行gcloud app versions list查看当前服务的流量分配，确认你修改了app.yaml的新版本已经收到100%流量，避免访问的是未更新配置的旧版本
• 排除控制台配置覆盖：如果在GAE控制台的「服务→对应版本→运行时配置」中手动设置过同名环境变量，控制台配置的优先级会高于app.yaml，会覆盖掉文件中的配置值
• 校验mustGetenv实现：确认你的mustGetenv方法底层调用的是标准库os.Getenv，没有拼写错误变量名，也没有硬编码默认值覆盖读取逻辑

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