Express.js 中间件基础与作用域
在 Express.js 中，中间件是处理请求和响应的核心机制。理解不同中间件应用方式的作用域至关重要：
- 全局应用 (app.use(middleware))： 当中间件不带路径参数直接通过 app.use() 应用时，它将对所有进入 Express 应用的请求生效。
- 路径限定应用 (app.use('/path', middleware))： 当中间件通过 app.use() 绑定特定路径时，它只对以该路径开头的请求生效。例如，app.use('/api', myMiddleware) 意味着 myMiddleware 只会在请求路径以 /api 开头时执行。
- 路由实例内部应用 (router.use(middleware))： 当中间件通过 router.use() 应用时，它只对该 router 实例内部定义的所有路由生效。无论该 router 实例最终被挂载到哪个路径，其内部的 router.use() 中间件都会在匹配到 router 内部路由时执行。
场景分析：精准控制路由前缀中间件
开发者在构建 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 中间件高级应用的关键一步。
