使用catalyst functions:shell执行Node.js函数时无法读取Zoho Catalyst环境变量

问题原因 #

catalyst functions:shell 默认不会自动加载本地环境变量，需要通过指定配置文件或绑定项目环境变量的方式让函数读取到。

解决方法 #

• 方法一：加载本地.env文件

  1. 在项目根目录创建 .env 文件，写入你的环境变量：

     MY_CUSTOM_VAR=your_value_here
     

  2. 运行shell时通过--env参数指定该文件：

     catalyst functions:shell --env .env
     

  3. 此时函数内可直接通过 process.env.MY_CUSTOM_VAR 获取值。

• 方法二：绑定Catalyst项目级环境变量（推荐）

  1. 使用CLI将环境变量添加到Catalyst开发环境：

     catalyst env:add --env development --key MY_CUSTOM_VAR --value your_value_here
     

  2. 直接运行catalyst functions:shell，无需额外参数，函数内即可通过process.env.MY_CUSTOM_VAR读取。

• 验证方式
  在Node.js函数中添加打印语句确认：

  exports.handler = async (event) => {
    console.log("环境变量值：", process.env.MY_CUSTOM_VAR);
    // 其他业务逻辑
  };
  

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