如何在部署前本地测试Node.js版Google Cloud Functions环境变量？

方法一：通过dotenv-yaml直接加载配置（侵入式） #

1. 安装开发依赖

   npm install dotenv-yaml --save-dev
   

2. 在函数入口文件（如index.js）最顶部添加加载代码：

   // 加载本地开发环境的YAML配置文件
   require('dotenv-yaml').config({ path: './.env-dev.yaml' });
   
   // 你的GCF函数代码
   exports.myFunction = (req, res) => {
     console.log(process.env.FOO); // 可直接访问YAML中的变量
     res.send('Hello World');
   };
   

3. 启动本地Functions Framework

   npx functions-framework --target=myFunction
   

方法二：用package.json脚本预加载配置（无侵入式） #

如果不想修改函数代码，可通过Node.js的-r参数预加载dotenv-yaml模块：

1. 先安装依赖：

   npm install dotenv-yaml --save-dev
   

2. 在package.json中添加启动脚本：

   {
     "scripts": {
       "start:dev": "npx functions-framework --target=myFunction -r dotenv-yaml/config dotenv-yaml_config_path=./.env-dev.yaml",
       "start:prod-sim": "npx functions-framework --target=myFunction -r dotenv-yaml/config dotenv-yaml_config_path=./.env.yaml"
     }
   }
   

3. 运行对应环境的启动命令：

   # 启动开发环境
   npm run start:dev
   # 模拟生产环境测试
   npm run start:prod-sim
   

关键注意事项 #

• YAML文件格式必须和GCF要求一致：仅支持一级键值对，不能嵌套，示例：

  FOO: "bar"
  DATABASE_URL: "postgresql://user:pass@localhost:5432/db"
  

• 本地环境不会自动生成GCF专属环境变量（如FUNCTION_NAME、GCP_PROJECT），若函数依赖这些变量，需在.env-dev.yaml中手动添加模拟值
• 务必将.env-dev.yaml和.env.yaml加入.gitignore，避免敏感信息泄露

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