如何在AWS Node.js Lambda中仅调用一次Parameter Store并复用值？

Lambda的执行环境有冷启动和热启动的区别：冷启动时会重新初始化整个函数的运行环境，而热启动会复用之前的环境，全局变量的状态也会被保留。你之前用全局变量失败，大概率是没处理好异步初始化的逻辑，或者没正确判断缓存是否存在。

下面是可行的实现方案：

1. 声明全局变量存储缓存的参数值
2. 封装异步函数调用SSM获取参数
3. 在handler中先检查缓存，不存在再调用SSM

完整代码示例 #

const AWS = require('aws-sdk');
const ssm = new AWS.SSM();

// 全局变量：存储缓存的参数值
let cachedParamValue;

// 封装获取SSM参数的异步函数
async function fetchSSMParameter() {
  try {
    const response = await ssm.getParameter({
      Name: '/your/target/parameter/key', // 替换成你的参数键
      WithDecryption: true // 如果参数是加密的，需要开启这个选项
    }).promise();
    return response.Parameter.Value;
  } catch (err) {
    console.error('获取SSM参数失败:', err);
    throw err;
  }
}

exports.handler = async (event, context) => {
  // 检查缓存是否存在，不存在则重新获取
  if (!cachedParamValue) {
    cachedParamValue = await fetchSSMParameter();
    console.log('首次加载参数完成');
  } else {
    console.log('使用缓存的参数');
  }

  // 业务逻辑中直接使用cachedParamValue
  console.log('当前参数值:', cachedParamValue);
  
  return {
    statusCode: 200,
    body: JSON.stringify({ message: '参数复用成功', paramValue: cachedParamValue })
  };
};

关键说明 #

• 缓存生效范围：全局变量的缓存仅在同一个Lambda执行环境中生效。当环境被AWS销毁（比如空闲超过15-30分钟，或者并发请求触发新环境创建），下次请求会触发冷启动，重新获取参数。这是Lambda的运行机制决定的，无法做到永久缓存，但能覆盖大部分复用场景。
• 异步处理注意：必须在handler中用await确保参数获取完成后再执行业务逻辑——如果直接在全局作用域调用异步函数，handler可能在参数获取完成前就执行，导致cachedParamValue还是undefined，这是很多人踩坑的点。
• 参数更新场景：如果你的参数需要定期更新，可以给缓存加个时间戳，比如每隔1小时重新获取一次，避免长期使用过期值。

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