Promise锁是解决缓存雪崩中并发回源问题的核心手段：通过内存级Map缓存pending的Promise，使同key请求共享同一回源任务，避免重复调用下游。
Promise 锁（Promise Cache）是解决缓存雪崩中“大量并发请求穿透到后端”的核心手段之一：当多个请求同时发现缓存失效，只让第一个请求真正回源加载数据，其余请求共享它返回的同一个 Promise，等其 resolve 后统一拿到结果，避免重复调用下游服务。
为什么需要 Promise 锁而不是普通缓存
普通缓存（如 Redis）只能防止「多次读缓存」，但无法阻止「多个请求同时发现缓存为空 → 全部发起回源请求」。尤其在热点 key 过期瞬间，可能有数百请求并发击穿，压垮数据库或接口。Promise 锁作用在内存层面，拦截的是「尚未完成的回源过程」，天然具备排他性。
Promise 锁的核心实现逻辑
关键在于用一个 Map（或 WeakMap）以请求标识（如 URL + 参数哈希）为 key，缓存正在执行中的 Promise 实例。后续相同请求直接复用该 Promise，不新建请求。
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 检查缓存（如 Redis），命中则直接返回数据
- 未命中时，先查 Promise 缓存 Map：若有 pending 的 Promise，直接 await 它
- 若 Map 中没有，则创建新 Promise（触发真实回源），存入 Map，并在 finally 中清理（避免内存泄漏）
一个轻量可复用的 Promise 锁封装示例
以下是一个生产可用的简易封装（支持自动清理、错误透出、防重复清理）：
立即学习“Java免费学习笔记（深入）”；
class PromiseLock {
constructor() {
this.cache = new Map();
}
// 生成唯一 key，建议包含业务上下文（如 apiPath + JSON.stringify(params)）
getKey(key) {
return typeof key === 'string' ? key : JSON.stringify(key);
}
async use(key, fetcher) {
const cacheKey = this.getKey(key);
// 1. 尝试获取已有 Promise
let promise = this.cache.get(cacheKey);
if (promise) {
return promise;
}
// 2. 创建新 Promise 并缓存
promise = fetcher().finally(() => {
// 确保只清理自己触发的 Promise（防竞态）
if (this.cache.get(cacheKey) === promise) {
this.cache.delete(cacheKey);
}
});
this.cache.set(cacheKey, promise);
return promise;
}
}
// 使用示例
const lock = new PromiseLock();
async function getDataWithCache(userId) {
const cacheKey = `user:${userId}`;
// 先查 Redis
const cached = await redis.get(cacheKey);
if (cached) return JSON.parse(cached);
// 缓存失效，走 Promise 锁
return lock.use(cacheKey, async () => {
const data = await callUserService(userId); // 真实 HTTP 或 DB 调用
await redis.setex(cacheKey, 60, JSON.stringify(data));
return data;
});
}
注意事项与进阶建议
- key 设计要精确：必须能区分不同参数组合，否则会误共享（如分页请求漏了 page 参数）
- 错误需透出且不缓存失败 Promise：上面示例中 fetcher 抛错时，Promise 仍会被缓存并拒绝 —— 多数场景应 catch 后重新 throw，或加 retry 逻辑
- 超时控制不能只靠 Promise 锁：需在 fetcher 内部加 timeout（如 AbortController），否则一个卡住的请求会让所有等待者无限挂起
- 分布式环境需配合分布式锁：单机 Promise 锁只对当前进程有效；多实例部署时，仍需 Redis 分布式锁兜底，Promise 锁作为第一层快速拦截
