Node.js 怎么用 AsyncLocalStorage 实现全链路请求追踪？

Question

仓乃文 · Accepted Answer

微服务中一个请求经过多个函数和模块，需要在每条日志中带上 requestId 才能串联完整调用链。手动传参侵入性大，AsyncLocalStorage 在异步调用链中自动传递上下文，无需修改函数签名即可在任何位置获取请求级数据。

基本用法：
```javascript
const { AsyncLocalStorage } = require("async_hooks");
const asyncLocalStorage = new AsyncLocalStorage();

// 中间件中设置上下文
app.use((req, res, next) => {
  asyncLocalStorage.run({ requestId: uuid(), userId: req.user?.id }, () => {
    next();
  });
});

// 任何地方获取上下文
function log(message) {
  const store = asyncLocalStorage.getStore();
  console.log(`[${store.requestId}] ${message}`);
}
```

数据库操作中自动传递：
```javascript
async function queryUser() {
  const store = asyncLocalStorage.getStore();
  // requestId 自动可用，无需层层传参
  log("查询用户");
  return db.query("SELECT * FROM users");
}
```

补充说明：
- AsyncLocalStorage 基于 async_hooks 实现，Node.js 16+ 稳定可用
- 替代了 cls-hooked 等第三方库，官方维护更可靠
- run() 内的所有同步和异步代码都能访问同一份 store
- getStore() 在 run() 外调用返回 undefined
- 适合请求追踪、租户隔离、事务上下文传递等场景