推荐使用AsyncLocalStorage实现隐式上下文透传，它能自动将tenantId延续到Promise链、setTimeout等异步边界；若不支持，则手动封装Promise工厂函数显式注入租户上下文。
在多租户系统中，Promise 本身不携带上下文，无法自动传递租户标识（如 tenantId），因此需手动将租户信息与异步操作绑定。核心思路是：**不让 Promise “裸奔”，而是通过封装、拦截或运行时绑定，确保每个异步阶段都能安全访问当前租户上下文**。
用 AsyncLocalStorage 实现隐式上下文透传
AsyncLocalStorage（Node.js 14.8+）是目前最推荐的方式，它能自动将上下文延续到 Promise 链、setTimeout、nextTick 等异步边界内，无需手动传递。
示例：
const { AsyncLocalStorage } = require('async_hooks');
<p>const tenantStorage = new AsyncLocalStorage();</p><p><span>立即学习</span>“<a href="https://pan.quark.cn/s/c1c2c2ed740f" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">Java免费学习笔记（深入）</a></a>”；</p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/xiazai/skill3430" title="Alibabacloud Sdk Client Initialization For Java"><img
src="https://img.php.cn/upload/skill/000/000/081/178955835420587.jpg" alt="Alibabacloud Sdk Client Initialization For Java" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/xiazai/skill3430" title="Alibabacloud Sdk Client Initialization For Java">Alibabacloud Sdk Client Initialization For Java</a>
<p>在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。</p>
</div>
<a href="/xiazai/skill3430" title="Alibabacloud Sdk Client Initialization For Java" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div><p>// 中间件：为每个请求绑定租户 ID
function tenantMiddleware(req, res, next) {
const tenantId = req.headers['x-tenant-id'] || 'default';
tenantStorage.run({ tenantId }, () => next());
}</p><p>// 工具函数：获取当前租户
function getCurrentTenant() {
return tenantStorage.getStore()?.tenantId;
}</p><p>// 在 Promise 内部可直接读取
async function fetchUserData(userId) {
const tenantId = getCurrentTenant(); // ✅ 自动拿到当前请求的 tenantId
return db.query('SELECT * FROM users WHERE tenant_id = ? AND id = ?', [tenantId, userId]);
}手动封装 Promise 工厂函数
若环境不支持 AsyncLocalStorage（如浏览器或旧版 Node），可显式将租户上下文作为参数注入 Promise 创建过程，避免闭包污染或意外复用。
- 定义一个工厂函数，接收
tenantId并返回带上下文的 Promise 构造器 - 所有异步操作（如 API 调用、数据库查询）都通过该工厂创建，确保上下文不丢失
- 避免在 Promise 回调中直接引用外部变量（如模块级
currentTenant），防止并发冲突
示例：
function createTenantPromise(tenantId) {
return (executor) => new Promise((resolve, reject) => {
executor(
(value) => resolve(value),
(err) => reject(err),
{ tenantId } // 显式注入上下文对象
);
});
}
<p>// 使用
const tenantPromise = createTenantPromise('acme-inc');
tenantPromise((resolve, reject, ctx) => {
api.getUser(123, ctx.tenantId).then(resolve).catch(reject);
});结合 Promise 链做上下文增强（不推荐但可行）
可在 Promise 链中每一步都手动“携带”租户信息，例如返回一个包含 tenantId 的对象，或使用 .then() 的第二个参数传递上下文。但这种方式易出错、冗余高，仅适合简单场景或临时适配。
- 每次
.then()后需显式返回{ data, tenantId }结构 - 错误处理时也需同步传递上下文，否则日志/监控无法关联租户
- 不适用于
await场景，因为 await 会解包值，丢失上下文容器
示例（谨慎使用）：
function withTenant(tenantId, promise) {
return promise.then(data => ({ data, tenantId }))
.catch(err => Promise.reject({ err, tenantId }));
}
<p>withTenant('acme-inc', fetch('/api/orders'))
.then(({ data, tenantId }) => {
console.log(<code>[${tenantId}] got ${data.length} orders</code>);
});数据库/HTTP 客户端层统一注入租户
更稳健的做法是把租户隔离下沉到基础设施层：让 DB client 或 HTTP client 自动从当前执行上下文读取 tenantId，并在 SQL 查询或请求头中自动添加。这样业务代码完全无感，Promise 只管异步流程，不操心上下文。
- 数据库层：重写 query 方法，在 SQL 中注入
WHERE tenant_id = ?或使用 schema 切换 - HTTP 层：封装
axios实例，通过拦截器自动加X-Tenant-ID头 - 配合
AsyncLocalStorage使用效果最佳，否则需依赖调用方传参
