为何Express中间件作用于所有请求方法？如何批量绑定控制器中间件

我有一个UserController，原本给每个路由单独绑定中间件的写法运行正常：

class UserController {
  async getAllUserData(req, res) { /* 获取数据并返回响应 */ }
  async changepassword(req, res) { /* 修改密码并返回响应 */ }
}
const ctrl = new UserController();
api.get('/user', middlewareA, ctrl.getAllUserData);
api.post('/changepassword', ctrl.changepassword);
export default api;

现在我想在index.js层面给这个控制器的所有方法统一绑定中间件，于是写成了这样：

/* 初始化... */
app.use((req, res, next) => {
  res.header('Access-Control-Allow-Origin', '*');
  res.header('Access-Control-Allow-Headers', 'Origin, X-Requested-With, Content-Type, Accept, Token');
  res.header('Access-Control-Allow-Methods', 'POST, GET, PUT, DELETE, OPTIONS');
  next();
});
app.use(middleware, UserController);
app.listen(3000, () => {
  console.log('Example app listening on port 3000!');
});

但现在发现中间件会作用于所有请求方法（包括浏览器发送的OPTIONS预请求），而我的控制器只有GET和POST方法。想请教：

1. 为什么这种写法下中间件会作用于所有方法？
2. 是不是必须为控制器的每个方法单独绑定中间件？

为什么中间件会作用于所有请求方法？ #

这是app.use()的核心工作机制决定的：

• app.use()是完全不区分HTTP请求方法的，如果没有指定路径参数，它会匹配所有路径下的所有请求方法——包括OPTIONS、PUT、DELETE这些你的控制器根本没处理的方法。
• 当你写app.use(middleware, UserController)时，中间件会在任何请求到达服务器的第一时间就执行，不管后续有没有对应的控制器方法来处理这个请求。浏览器发送的OPTIONS预请求自然也会触发这个中间件，因为它完全符合app.use()的匹配规则。

另外还要注意：你直接把UserController类传给app.use()其实是错误的——Express的use方法接收的是中间件函数或者路由实例，而不是类本身，这种写法根本无法正确把控制器方法绑定到对应路由上，反而会让中间件无差别作用于所有请求。

不需要为每个方法单独绑定中间件，有更优雅的解决方案 #

你可以通过路由分组的方式，给控制器的所有路由统一绑定中间件，同时避免作用于无关请求：

方案1：用Express Router分组控制器路由

先把控制器的所有路由整合到一个Router实例中，然后给这个Router绑定中间件，最后挂载到app上：

// 控制器模块代码
import express from 'express';
const router = express.Router();

class UserController {
  async getAllUserData(req, res) { /* 获取数据并返回响应 */ }
  async changepassword(req, res) { /* 修改密码并返回响应 */ }
}
const ctrl = new UserController();

// 给Router添加控制器路由
router.get('/user', ctrl.getAllUserData);
router.post('/changepassword', ctrl.changepassword);

export default router;

然后在index.js里给这个Router统一绑定中间件：

import express from 'express';
import userRouter from './path/to/userController.js';
const app = express();

// CORS中间件：直接处理OPTIONS预请求，避免走到后续中间件
app.use((req, res, next) => {
  res.header('Access-Control-Allow-Origin', '*');
  res.header('Access-Control-Allow-Headers', 'Origin, X-Requested-With, Content-Type, Accept, Token');
  res.header('Access-Control-Allow-Methods', 'POST, GET, PUT, DELETE, OPTIONS');
  
  if (req.method === 'OPTIONS') {
    return res.sendStatus(200);
  }
  next();
});

// 给用户路由组统一绑定中间件
app.use('/api', middleware, userRouter);

app.listen(3000, () => {
  console.log('Example app listening on port 3000!');
});

这样一来，middleware只会作用于/api路径下的所有用户路由（也就是GET /api/user和POST /api/changepassword），不会影响其他路由，同时OPTIONS请求也被CORS中间件直接处理了，不会走到业务中间件和控制器。

方案2：控制器类层面统一包裹中间件（进阶）

如果你希望控制器类的所有方法自动应用中间件，可以封装一个简单的工具函数，给控制器的每个方法都包裹上中间件：

function wrapControllerWithMiddleware(controller, middleware) {
  const wrapped = {};
  for (const key in controller) {
    if (typeof controller[key] === 'function') {
      // 用中间件包裹控制器方法
      wrapped[key] = (req, res, next) => {
        middleware(req, res, () => {
          controller[key](req, res, next);
        });
      };
    }
  }
  return wrapped;
}

// 使用方式
const ctrl = new UserController();
const wrappedCtrl = wrapControllerWithMiddleware(ctrl, middleware);

router.get('/user', wrappedCtrl.getAllUserData);
router.post('/changepassword', wrappedCtrl.changepassword);

这种方式可以避免手动给每个路由绑定中间件，但本质上还是基于Router分组，只是简化了绑定步骤。

总结 #

• app.use()本身就是全局匹配所有请求方法的，不能直接用来给特定控制器的方法绑定中间件；
• 最推荐的方式是用Express Router做路由分组，给整个路由组统一绑定中间件；
• 可以在CORS中间件里直接处理OPTIONS请求，避免它触发后续业务中间件。

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