Node.js Async LocalStorage中间件中next函数的作用解析

要搞懂这个问题，得先明白Async LocalStorage（以下简称ALS）的核心作用：在整个异步调用链里共享请求级别的上下文，而run()就是创建并绑定这个上下文的关键入口。

1. run()的底层逻辑 #

调用asyncLocalStorage.run(store, callback)时，Node.js会做两件事：

• 创建一个独立的上下文存储（就是你传入的Map）；
• 把这个上下文和当前的异步调用栈绑定，只要是在callback里触发的操作，以及后续所有由它衍生的异步任务（比如Promise、setTimeout、数据库查询），都能通过getStore()拿到这个上下文。

一旦callback执行完毕，这个上下文就会被自动解绑，后续的代码无法再访问它。

2. next()放在run()内的必要性 #

Express里的next()是触发后续中间件、路由处理的入口——整个请求的业务逻辑（从路由处理到数据库查询，再到响应返回），全都是通过next()启动的异步调用链。

如果把next()移出run()的回调，就意味着：

• run()的回调执行完就销毁了上下文；
• next()触发的后续代码根本没绑定到这个上下文上，自然拿不到你设置的requestId，中间件直接失效。

结合你的代码理解 #

你的正确代码里：

app.use((req, res, next) => {
  asyncLocalStorage.run(new Map(), () => {
    asyncLocalStorage.getStore().set("requestId", uuid());
    next(); // 这里在run的回调内，触发后续链路
  });
});

执行流程是：

1. 为当前请求创建一个独立的Map存储；
2. 往这个存储里存入requestId；
3. 调用next()，触发后续中间件/路由——这些代码全处于ALS的上下文绑定范围内，任何地方调用asyncLocalStorage.getStore().get("requestId")都能拿到值。

如果改成这样：

app.use((req, res, next) => {
  asyncLocalStorage.run(new Map(), () => {
    asyncLocalStorage.getStore().set("requestId", uuid());
  });
  next(); // 移出run回调
});

run()的回调执行完就销毁了上下文，next()启动的后续链路完全没绑定到这个存储，自然拿不到requestId，中间件就失效了。

额外补充 #

ALS的上下文是请求隔离的——每个请求的run()都会创建独立的存储，互不干扰。把next()包在run()里，才能让整个请求的处理链路都挂在这个独立上下文上，实现每个请求拥有唯一trace id的需求。

内容的提问来源于stack exchange，提问作者Samuel Josh