答案：构建Node.js中间件应用需理解中间件按序执行、调用next()进入下一中间件、可终止响应流程；通过Express设置基础结构，分离日志、权限等模块化中间件，合理组织执行顺序，并在路由后定义四参数错误处理中间件以捕获同步异步异常，确保应用稳定可维护。
构建一个基于中间件架构的 Node.js 应用，核心在于理解中间件的执行流程和如何组织它们来处理请求。Node.js 本身并不强制使用中间件模式，但通过 Express 或 Koa 这类框架可以轻松实现。下面介绍如何从零开始设计一个结构清晰、可扩展的中间件应用。
理解中间件的工作机制
中间件是一个函数，它接收请求对象（req）、响应对象（res）和下一个中间件函数（next）。它的作用是在请求到达路由处理程序之前或之后执行某些逻辑，比如日志记录、身份验证、数据解析等。
关键点：
- 中间件按定义顺序依次执行
- 调用 next() 才会进入下一个中间件
- 如果不调用 next()，后续中间件和路由将不会被执行
- 可以通过 res.end() 或 res.send() 终止请求响应流程
搭建基础中间件结构
以 Express 为例，初始化项目并设置常用中间件：
// app.js
const express = require('express');
const app = express();
// 解析 JSON 请求体
app.use(express.json());
// 记录请求日志
app.use((req, res, next) => {
console.log(`${new Date().toISOString()} ${req.method} ${req.path}`);
next();
});
// 路由前的权限校验中间件
app.use('/admin', (req, res, next) => {
if (req.headers['x-admin']) {
next();
} else {
res.status(403).send('Forbidden');
}
});
app.get('/', (req, res) => {
res.send('Hello World');
});
app.get('/admin/dashboard', (req, res) => {
res.send('Admin Dashboard');
});
module.exports = app;
模块化与自定义中间件分离
随着应用增长，应将中间件拆分为独立模块，提升可维护性。
// middleware/logger.js
module.exports = (req, res, next) => {
console.time(`Request-${req.id}`);
req.id = Math.random().toString(36);
console.log(`Incoming: ${req.method} ${req.path}`);
res.on('finish', () => {
console.timeEnd(`Request-${req.id}`);
});
next();
};
// middleware/auth.js
module.exports = (role) => {
return (req, res, next) => {
const userRole = req.headers['x-role'] || 'guest';
if (userRole === role) {
next();
} else {
res.status(403).send('Access denied');
}
};
};
在主文件中引入：
const logger = require('./middleware/logger');
const auth = require('./middleware/auth');
app.use(logger);
app.use('/admin', auth('admin'));
错误处理中间件
错误处理中间件有四个参数 (err, req, res, next)，必须写在所有路由之后。
// 模拟一个出错的路由
app.get('/error', () => {
throw new Error('Something went wrong');
});
// 专门的错误处理中间件
app.use((err, req, res, next) => {
console.error(err.stack);
res.status(500).send('Something broke!');
});
也可以在异步操作中使用 next(err) 触发错误流：
app.get('/async-error', (req, res, next) => {
setTimeout(() => {
next(new Error('Async error'));
}, 100);
});
基本上就这些。只要理清中间件的链式调用逻辑，合理分层和解耦，就能构建出稳定、易维护的 Node.js 应用。不复杂但容易忽略的是执行顺序和 next() 的控制，务必小心处理。
