编写异步安全单例的最佳实践：Node.js如何保证IPFS节点全局唯一

原有代码的并发问题 #

现有实现的核心漏洞是：当多个调用在第一个ipfs.create()异步操作完成前同时触发getIPFSNode，所有调用都会判定ipfsNode === undefined成立，进而重复执行实例创建逻辑，最终生成多个IPFS节点实例，无法满足全局唯一的要求。

方案1：零依赖原生实现（推荐，适配绝大多数单例场景） #

利用JS单线程事件循环的特性，直接缓存实例创建的Promise对象而非创建完成的实例，从根源上避免重复初始化：

// 缓存初始化Promise，而非最终实例
let ipfsNodePromise = null;

const getIPFSNode = async () => {
  if (!ipfsNodePromise) {
    // 此处不要加await，同步完成Promise赋值，保证判断+赋值操作原子性
    const ipfsModulePromise = import('ipfs-core');
    ipfsNodePromise = ipfsModulePromise.then(ipfs => ipfs.create());
  }
  // 所有调用共享同一个Promise，只会执行一次创建逻辑
  return ipfsNodePromise;
};

方案特性 #

• 无额外依赖，性能开销为0
• 判断与赋值是同步操作，事件循环不会在这两个操作之间插入其他并发调用，天然具备原子性
• 支持初始化失败重试，只需在catch逻辑中清空缓存即可：

let ipfsNodePromise = null;

const getIPFSNode = async () => {
  if (!ipfsNodePromise) {
    const ipfsModulePromise = import('ipfs-core');
    ipfsNodePromise = ipfsModulePromise
      .then(ipfs => ipfs.create())
      .catch(err => {
        // 初始化失败时重置缓存，允许后续调用重新尝试创建
        ipfsNodePromise = null;
        throw err;
      });
  }
  return ipfsNodePromise;
};

方案2：互斥锁+双重检查（适配复杂场景） #

如果需要支持实例销毁重建、多资源互斥初始化等复杂逻辑，可以使用互斥锁（Mutex）配合双重检查锁模式实现：

// 互斥锁逻辑示例，可根据项目依赖选择对应实现
import { Mutex } from 'async-mutex';
const initLock = new Mutex();
let ipfsNode = null;

const getIPFSNode = async () => {
  // 无锁快速判断，减少不必要的锁开销
  if (ipfsNode) return ipfsNode;
  // 获取初始化锁
  const releaseLock = await initLock.acquire();
  try {
    // 拿到锁后二次检查：避免锁等待期间其他调用已经完成实例创建
    if (ipfsNode) return ipfsNode;
    // 执行初始化逻辑
    const ipfs = await import('ipfs-core');
    ipfsNode = await ipfs.create();
    return ipfsNode;
  } finally {
    // 无论初始化成功失败都要释放锁
    releaseLock();
  }
};

选型建议 #

• 全局单例初始化场景优先选择缓存Promise的方案，简单可靠无额外开销
• 仅当存在实例动态销毁重建、多初始化流程互斥等复杂需求时，再使用互斥锁方案

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