如何设计模块以确保它只初始化一次?
参考答案
目标
确保一个模块的初始化逻辑(如建立连接、注册全局监听、初始化配置)在整个应用生命周期内只执行一次,即使被多处 import 或并发调用。
方案一:利用模块缓存(最标准)
ESM/CJS 的模块天然只执行一次:首次 import/require 执行模块代码,后续直接返回缓存的导出。
// db.js
let client;
export function getClient() {
if (!client) client = createClient(); // 懒初始化
return client;
}
// 任意位置 import { getClient } from './db' 都拿到同一个实例
要点:把"初始化"放在模块顶层或首次调用的惰性分支里,依赖模块缓存即可保证唯一。
方案二:单例模式(显式控制)
class Store {
static #instance;
static getInstance() {
if (!Store.#instance) Store.#instance = new Store();
return Store.#instance;
}
}
方案三:幂等标记(跨模块/跨包也安全)
const KEY = Symbol.for('app.init');
function initOnce(fn) {
if (globalThis[KEY]) return globalThis[KEY];
return (globalThis[KEY] = fn());
}
用 Symbol.for(全局注册表)避免多份库各自持有一个 Symbol,导致重复初始化。
方案四:并发安全(异步初始化)
模块缓存只保证"同步执行一次",异步初始化可能被并发触发多次:
let initPromise;
export function init() {
if (!initPromise) initPromise = doInit(); // 缓存 Promise
return initPromise; // 所有调用方共享同一个 Promise
}
关键:缓存 Promise 而不是结果,否则并发时仍会重复执行。
方案五:分布式场景(多实例/多进程)
模块缓存只在单进程内有效。多副本部署时需要用外部协调:
- Redis
SETNX分布式锁 + 标记位; - 数据库唯一约束(
INSERT ... ON CONFLICT DO NOTHING); - 定时任务/初始化脚本单独跑一次,应用只读结果。
注意
- 热更新/动态
import不同 URL 会生成新模块实例,不能依赖缓存。 - 测试中需要重置单例时要提供
reset方法(仅测试环境)。 - 别把"只执行一次"和"线程安全"混为一谈,浏览器/Node 单线程但异步并发仍需缓存 Promise。