Express.js中如何让usePermissions钩子自动获取request对象

我在后端开发中实现了一个类React风格的权限验证辅助方法usePermissions，它会根据特定条件返回布尔值，但目前每次调用都必须手动传入req对象，示例代码如下：

import usePermissions from 'hooks/usePermissions'

usersRouter.delete('/users/:userId', async (req, res, next)=>{
  const { verify } = usePermissions(req)
  if(verify('deleteUsers')) await UserModel.delete(req.params.userId)
  // ...
})

我希望能让usePermissions自动获取request对象，实现无需手动传参的调用方式：

import usePermissions from 'hooks/usePermissions'

usersRouter.delete('/users/:userId', async (req, res, next)=>{
  const { verify } = usePermissions() // 无需传入req
  if(verify('deleteUsers')) await UserModel.delete(req.params.userId)
  // ...
})

请问有没有可行的实现方案？

基于Node.js AsyncLocalStorage 的方案（适用于Express/Koa等框架） #

这是Node.js官方提供的异步上下文存储API，能在整个请求生命周期内安全共享req对象，避免手动传递的繁琐。

1. 创建上下文存储模块
   新建src/context.js：

const { AsyncLocalStorage } = require('async_hooks');

const requestContext = new AsyncLocalStorage();

module.exports = {
  requestContext,
  wrapRequest: (req, res, next) => {
    requestContext.run(new Map(), () => {
      requestContext.getStore().set('req', req);
      next();
    });
  }
};

2. 在主入口注册中间件
   以Express的入口文件app.js为例，确保这个中间件在所有路由和业务中间件之前注册：

const { wrapRequest } = require('./context');

app.use(wrapRequest);

3. 修改usePermissions钩子
   更新hooks/usePermissions.js，从上下文自动获取req：

const { requestContext } = require('../context');

function usePermissions() {
  const store = requestContext.getStore();
  if (!store) {
    throw new Error('usePermissions 必须在请求上下文内调用');
  }
  const req = store.get('req');

  const verify = (permission) => {
    // 这里替换成你的实际权限验证逻辑，比如从req.user中读取权限对比
    return req.user?.permissions?.includes(permission);
  };

  return { verify };
}

module.exports = usePermissions;

4. 路由中直接调用
   现在就可以按照你期望的方式调用，无需手动传入req：

import usePermissions from 'hooks/usePermissions'

usersRouter.delete('/users/:userId', async (req, res, next)=>{
  const { verify } = usePermissions()
  if(verify('deleteUsers')) await UserModel.delete(req.params.userId)
  // ...
})

针对Koa框架的简化方案（可选） #

如果使用Koa框架，因为自带ctx上下文，也可以通过中间件临时挂载全局（但注意复杂异步场景下可能有上下文污染风险，优先推荐AsyncLocalStorage方案）：

1. 注册挂载上下文的中间件

app.use(async (ctx, next) => {
  global._currentCtx = ctx;
  await next();
  global._currentCtx = null;
});

2. 修改usePermissions

function usePermissions() {
  if (!global._currentCtx) {
    throw new Error('usePermissions 必须在请求上下文内调用');
  }
  const req = global._currentCtx.req;

  const verify = (permission) => {
    // 权限验证逻辑
    return req.user?.permissions?.includes(permission);
  };

  return { verify };
}

内容的提问来源于stack exchange，提问作者Islam Y-