使用Express+AppEngine时无法通过dotenv读取.yaml文件环境变量怎么办

问题原因 #

dotenv仅支持解析标准.env格式的纯文本键值对文件，无法直接识别YAML格式的配置，所以现有写法读取不到变量属于正常情况。

解决方法 #

1. 安装YAML解析依赖 #

安装js-yaml库用于解析YAML文件：

npm install js-yaml

2. 本地开发加载YAML环境变量 #

修改你的index.js代码，手动解析.secrets.yaml并将变量挂载到process.env上：

import fs from 'fs';
import yaml from 'js-yaml';

// 仅本地开发环境加载本地yaml配置，避免和AppEngine线上注入的环境变量冲突
if (process.env.NODE_ENV !== 'production') {
  // 读取yaml文件，注意路径对应你实际的文件位置
  const yamlContent = fs.readFileSync('./.secrets.yaml', 'utf8');
  const config = yaml.load(yamlContent);
  // 将yaml内的环境变量合并到process.env
  Object.assign(process.env, config.env_variables);
}

console.log(process.env.test); // 输出 test1234

3. AppEngine部署适配 #

如果你的.secrets.yaml是单独拆分的敏感配置，需要在主app.yaml中添加引入配置，部署后AppEngine会自动将变量注入到运行环境：

# app.yaml 中添加
includes:
  - .secrets.yaml

注意事项 #

• 务必将.secrets.yaml加入.gitignore，避免敏感信息提交到代码仓库
• 读取文件时的相对路径是相对于项目启动命令的执行目录，路径错误会导致文件读取失败

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