如何避免JavaScript类在AWS Lambda多线程环境中重复初始化

问题根源 #

你当前的代码存在异步竞态条件：当多个请求同时触发Lambda执行时，第一个请求还没完成client.initialize()并把实例存入map，后续请求就会检测到this.map.get(name)返回undefined，进而重复创建客户端实例。

解决方案 #

1. 缓存初始化Promise而非实例

因为初始化是异步操作，直接缓存实例会导致竞态，改成缓存初始化的Promise，让后续请求等待同一个Promise完成，就能避免重复创建。修改后的代码如下：

const clientFactory = new ClientFactory();

export const handler = async (event) => {
  const instance = await clientFactory.getInstance("some name");
}
      
export class ClientFactory {
  // 用Map缓存客户端初始化的Promise，而非实例
  private clientInitPromises = new Map<string, Promise<any>>();

  getInstance = async (name: string) => {
    let initPromise = this.clientInitPromises.get(name);
    if (!initPromise) {
      // 把初始化逻辑包装成Promise并存入Map
      initPromise = (async () => {
        const client = this.createClient(name);
        await client.initialize();
        return client;
      })();
      this.clientInitPromises.set(name, initPromise);

      // 初始化失败时清理缓存，避免一直持有失败的Promise
      initPromise.catch(() => {
        this.clientInitPromises.delete(name);
      });
    }
    return initPromise;
  }

  // 你的客户端创建逻辑
  private createClient(name: string) {
    return {
      getName: () => name,
      initialize: async () => {
        // 这里替换成实际的初始化逻辑
        await new Promise(resolve => setTimeout(resolve, 100));
      }
    };
  }
}

2. 认清Lambda执行环境的隔离性

• Lambda的每个执行实例是完全独立的，handler外的代码只会在实例冷启动时执行一次。同一个实例内的并发调用会共享clientFactory，但不同Lambda实例之间无法共享状态，各自会有自己的clientFactory实例——这是Lambda的设计特性，属于正常情况，无需强行跨实例共享单例（除非用外部存储，比如Redis，但通常没必要）。

3. 可选：添加错误处理兜底

如果客户端初始化失败，记得清理对应的Promise缓存，避免后续请求一直复用失败的Promise，上面的代码已经包含了这个逻辑。

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