能否在全局作用域中通过Express识别请求并获取requestId？

你当前的代码存在核心问题：express.Request是请求对象的构造函数，并非当前请求的实例，直接访问它的app.locals会共享所有请求的数据，必然导致请求间互相覆盖。要实现无需传递req、请求级数据隔离的需求，Node.js的AsyncLocalStorage是最适合的方案，它能在异步调用链中保存和获取当前请求的上下文数据。

实现步骤与完整代码 #

const express = require('express');
const { AsyncLocalStorage } = require('async_hooks');
const router = express.Router();

// 初始化异步本地存储实例，用于保存请求上下文
const requestContext = new AsyncLocalStorage();

// 自定义中间件：将当前请求的requestId存入上下文
const setRequestContext = (req, res, next) => {
  // 创建上下文对象，存储当前请求的requestId
  const context = {
    requestId: req.app.locals.requestId
  };
  // 运行后续中间件/路由处理函数，绑定上下文
  requestContext.run(context, next);
};

// 需要获取requestId的函数，无需传入req
const execute = () => {
  // 从上下文获取当前请求的requestId
  const context = requestContext.getStore();
  console.log(context?.requestId);
};

// 注册上下文中间件，确保所有路由都能使用上下文
router.use(setRequestContext);

router.get('/test1', (req, res) => {
  req.app.locals.requestId = 1;
  setTimeout(() => {
    execute();  // 输出 1
  }, 2000);
  res.send('test1 initiated');
});

router.get('/test2', (req, res) => {
  req.app.locals.requestId = 2;
  setTimeout(() => {
    execute();  // 输出 2
  }, 1000);
  res.send('test2 initiated');
});

router.get('/test3', (req, res) => {
  setTimeout(() => {
    execute();  // 输出 undefined
  }, 3000);
  res.send('test3 initiated');
});

const app = express();
app.use(router);
app.listen(3000);

关键说明 #

• AsyncLocalStorage会自动跟踪异步调用链（比如setTimeout、数据库查询等异步操作），确保execute函数能获取到发起当前异步操作的请求上下文。
• 中间件setRequestContext在每个请求进入时创建独立的上下文，并通过run方法绑定到后续的处理流程中，实现请求间的完全隔离。
• 无需在execute或其他函数中传递req，直接通过requestContext.getStore()即可拿到当前请求的上下文数据。

验证效果 #

• 先调用/test1，再调用/test2：test2的setTimeout先执行，输出2；2秒后test1的execute执行，输出1，两者数据互不干扰。
• 调用/test3：因为没有设置requestId，所以输出undefined，符合预期。

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