在 Express.js 中，中间件是处理请求和响应的核心机制。理解不同中间件应用方式的作用域至关重要：
开发者在构建 RESTful API 或模块化应用时，常会使用 express.Router() 来组织路由。一个常见需求是，某个特定的中间件（例如，身份验证、日志记录）只应在访问特定 API 前缀（如 /api）下的路由时执行，而不应影响其他可能存在的根路由或不同前缀的路由。
例如，我们有一个 apiRouter 负责处理所有 /api 开头的请求，并希望一个 authMiddleware 仅在 /api 路径下生效。如果我们将 authMiddleware 直接通过 router.use(authMiddleware) 应用到 apiRouter，那么只要请求进入 apiRouter 内部的任何路径，authMiddleware 都会执行。但我们可能需要更明确地在应用层面，当且仅当请求路径匹配 /api 前缀时才激活这个中间件。
Express.js 提供了一种简洁且明确的方式来实现这一目标：在 app.use() 挂载路由时，直接将中间件作为参数传递。
语法结构：
app.use('/path', middlewareFunction, routerInstance);这种方式的原理是，当请求路径匹配 /path 时，middlewareFunction 会首先执行。如果 middlewareFunction 调用了 next()，请求流会接着传递给 routerInstance 进行处理。这意味着 middlewareFunction 仅在 /path 前缀被匹配时才会被激活，且在请求到达 routerInstance 内部的路由处理逻辑之前执行。
考虑以下原始代码，其中 routerMiddleware 通过 router.use() 应用：
const express = require('express');
const app = express();
// 创建一个路由实例
const router = express.Router();
// 定义一个路由特定的中间件
const routerMiddleware = (req, res, next) => {
console.log('Router middleware executed'); // 原始代码中，此日志在 /api/* 路径下会打印
next();
};
// 原始方式：在路由实例内部应用中间件
// router.use(routerMiddleware); // 这种方式会使 routerMiddleware 对此 router 内部所有路由生效
// 在路由实例上定义一个路由
router.get('/example', (req, res) => {
res.send('Hello from the router');
});
// 将路由挂载到应用上
app.use('/api', router); // 此时 routerMiddleware 已经对 /api/* 生效
// 启动服务器
app.listen(3000, () => {
console.log('Server started on port 3000');
});在上述代码中，尽管 router.use(routerMiddleware) 看起来是应用到 router 实例内部，但由于 router 最终被挂载到 /api，实际上 routerMiddleware 也只会在访问 /api/* 路径时执行。然而，为了更清晰地表达中间件与特定路径的关联，推荐使用以下改进方案：
优化后的代码示例：
const express = require('require');
const app = express();
// 创建一个路由实例
const router = express.Router();
// 定义一个路由前缀特定的中间件
const routerMiddleware = (req, res, next) => {
console.log('Router middleware executed for /api path');
next();
};
// 在路由实例上定义一个路由
router.get('/example', (req, res) => {
res.send('Hello from the router');
});
// 推荐方式：在应用层挂载路由时，将中间件绑定到特定路径
// 这样 routerMiddleware 只会在请求路径以 '/api' 开头时执行，
// 并且在请求被 router 处理之前执行。
app.use('/api', routerMiddleware, router);
// 启动服务器
app.listen(3000, () => {
console.log('Server started on port 3000');
console.log('--------------------------------------------------');
console.log('测试用例:');
console.log('访问 http://localhost:3000/api/example');
console.log(' -> 控制台会输出 "Router middleware executed for /api path"');
console.log(' -> 浏览器显示 "Hello from the router"');
console.log('--------------------------------------------------');
console.log('访问 http://localhost:3000/ (或其他非 /api 路径)');
console.log(' -> 控制台不会输出 "Router middleware executed for /api path"');
console.log(' -> 浏览器显示 "Cannot GET /" (因为没有定义根路由)');
console.log('--------------------------------------------------');
});通过上述优化，routerMiddleware 的执行被明确地绑定到了 /api 路径前缀。只有当请求路径以 /api 开头时，routerMiddleware 才会执行。这使得中间件的逻辑与路由的挂载路径更加紧密和清晰地关联起来。
中间件执行顺序： 在 app.use('/path', middleware, router) 这种形式中，middleware 会在 router 实例内部的任何中间件和路由处理函数之前执行。
作用域清晰性： 这种方式提供了更高的清晰度，明确地表明了某个中间件是为特定路由前缀服务的，而不是为整个 router 实例服务的。这有助于大型应用中中间件的管理和调试。
结合 router.use()： 如果一个 router 实例内部确实需要一些对其所有子路由都生效的中间件（例如，解析请求体的中间件），仍然可以在 router 实例内部使用 router.use()。这两种方式可以结合使用，以满足不同的需求。
const apiRouter = express.Router();
apiRouter.use(express.json()); // 对 /api 下所有路由解析 JSON 请求体
const authMiddleware = (req, res, next) => { /* ... */ next(); };
apiRouter.get('/users', (req, res) => { /* ... */ });
// authMiddleware 仅在 /api 路径下执行，且在 express.json() 之后
// 错误：authMiddleware 在 express.json() 之前执行。
// 如果希望 authMiddleware 在 express.json() 之后，则应该这样：
// app.use('/api', express.json(), authMiddleware, apiRouter);
// 或者将 authMiddleware 放在 apiRouter 内部：
// apiRouter.use(authMiddleware);
// app.use('/api', apiRouter); // 此时 authMiddleware 依然只对 /api/* 生效
// 这里的关键是理解执行顺序和作用域。修正上述错误理解：如果 authMiddleware 需要在 express.json() 之后执行，且只针对 /api，那么应该将 express.json() 放在 app.use 中 authMiddleware 之前，或者将 express.json() 和 authMiddleware 都放在 apiRouter 内部。
正确示例：
const express = require('express');
const app = express();
const apiRouter = express.Router();
// 定义一个路由前缀特定的身份验证中间件
const authMiddleware = (req, res, next) => {
console.log('Authentication middleware executed for /api path');
// 假设这里进行身份验证逻辑
// if (!req.headers.authorization) return res.status(401).send('Unauthorized');
next();
};
// 定义一个解析 JSON 请求体的中间件，仅对 apiRouter 内部生效
apiRouter.use(express.json());
// 在 apiRouter 上定义路由
apiRouter.get('/users', (req, res) => {
res.json({ message: 'List of users' });
});
apiRouter.post('/users', (req, res) => {
console.log('Request Body:', req.body);
res.json({ message: 'User created', data: req.body });
});
// 在应用层挂载 apiRouter，并在此处应用 authMiddleware
// authMiddleware 会在请求到达 apiRouter 之前执行，但仅对 /api 路径有效
app.use('/api', authMiddleware, apiRouter);
app.listen(3000, () => {
console.log('Server started on port 3000');
console.log('Try: POST http://localhost:3000/api/users with {"name": "test"}');
console.log('Try: GET http://localhost:3000/api/users');
});在这个修正后的例子中，authMiddleware 在 app.use 中被应用到 /api 路径，它会在 apiRouter 接收请求之前执行。而 express.json() 则是 apiRouter 内部的中间件，会在 apiRouter 接收到请求后，但在具体的 /users 路由处理函数之前执行。
通过在 app.use('/path', middleware, router) 的方式挂载路由，我们能够以更精确、更可读的方式管理 Express.js 应用中的中间件。这种方法确保了中间件只在它真正需要的特定路由前缀下执行，避免了不必要的全局或宽泛的应用，有助于构建结构清晰、性能高效且易于维护的 Express.js 应用。理解并善用这种模式，是掌握 Express.js 中间件高级应用的关键一步。
广告
收藏
收藏
收藏
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号
951
