如何从JSON配置文件传递列表作为环境变量给AWS Lambda函数？

问题根源是Serverless框架的environment属性仅支持字符串类型的环境变量值，无法直接传入数组或对象结构。以下是几种适配现有架构的解决方法：

方案一：自定义JS变量解析脚本 #

通过编写简单的Node.js脚本，读取JSON配置并将环境数组序列化为JSON字符串，供Serverless框架调用。

1. 创建resolve-env.js脚本：

const fs = require('fs');
const path = require('path');

module.exports = () => {
  const clientName = process.env.CLIENT_NAME;
  if (!clientName) throw new Error('CLIENT_NAME environment variable is required');
  
  const configPath = path.join(__dirname, 'serverlessConfig.json');
  const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
  
  const envArray = config[clientName]?.environment || [];
  return JSON.stringify(envArray);
};

2. 修改serverless.yml配置：

custom:
  containerEnv: ${file(resolve-env.js)}

environment:
  CONTAINER_ENVIRONMENT: ${self:custom.containerEnv}

运行sls invoke local时，脚本会自动将目标环境数组转为JSON字符串，符合环境变量的格式要求。

方案二：Lambda内部直接读取配置文件 #

跳过在Serverless层面传递复杂结构，改为在Lambda函数内部直接读取JSON配置文件，根据CLIENT_NAME获取对应环境配置。

1. 修改Lambda函数代码：

const fs = require('fs');
const config = JSON.parse(fs.readFileSync('./serverlessConfig.json', 'utf8'));

exports.handler = async (event) => {
  const clientName = process.env.CLIENT_NAME;
  const containerEnvironment = config[clientName]?.environment || [];
  
  // 后续业务逻辑使用containerEnvironment数组
  console.log('Container environment:', containerEnvironment);
  return { statusCode: 200 };
};

2. 更新serverless.yml配置：

environment:
  CLIENT_NAME: ${env:CLIENT_NAME}

package:
  include:
    - serverlessConfig.json # 将配置文件打包进Lambda部署包

这种方式避免了Serverless环境变量的格式限制，同时更便于维护多客户端的配置。

方案三：使用Serverless变量的字符串化处理（兼容本地运行） #

如果不想编写额外脚本，可以利用Serverless的变量语法结合JSON.stringify，通过自定义变量间接实现：

custom:
  rawEnv: ${file(serverlessConfig.json):${env:CLIENT_NAME}.environment}
  containerEnv: ${json.stringify(${self:custom.rawEnv})}

environment:
  CONTAINER_ENVIRONMENT: ${self:custom.containerEnv}

注意：部分旧版本Serverless可能不支持这种嵌套变量语法，需确保使用较新版本的框架。

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