常用中间件库推荐与比较

Express框架作为Node.js中最流行的Web框架之一，其生态系统中存在大量中间件库用于扩展功能。不同中间件适用于不同场景，选择合适的工具能显著提升开发效率。

基础中间件

body-parser

处理HTTP请求体数据的经典中间件，支持JSON、URL编码和原始数据解析。虽然Express 4.16+已内置类似功能，但在旧版本项目中仍常见。

const bodyParser = require('body-parser');
app.use(bodyParser.json()); // 解析JSON格式
app.use(bodyParser.urlencoded({ extended: true })); // 解析表单数据

morgan

HTTP请求日志记录器，提供多种预定义格式和自定义选项：

const morgan = require('morgan');
app.use(morgan('combined')); // 使用标准Apache组合日志格式
app.use(morgan(':method :url :status :response-time ms')); // 自定义格式

helmet

安全防护中间件集合，通过设置HTTP头增强安全性：

const helmet = require('helmet');
app.use(helmet()); // 默认启用所有安全策略
app.use(helmet.contentSecurityPolicy()); // 单独配置CSP策略

路由相关中间件

express-router

虽然Express自带路由功能，但大型项目需要更结构化方案：

const router = express.Router();
router.get('/users', (req, res) => { /* ... */ });
app.use('/api', router); // 挂载到特定路径

cors

处理跨域请求的灵活解决方案：

const cors = require('cors');
app.use(cors()); // 完全开放跨域
app.use(cors({
  origin: 'https://example.com',
  methods: ['GET','POST']
})); // 精细化控制

会话与认证

express-session

服务器端会话管理基础中间件：

const session = require('express-session');
app.use(session({
  secret: 'your-secret-key',
  resave: false,
  saveUninitialized: true,
  cookie: { secure: true }
}));

passport.js

认证中间件生态系统，支持300+策略：

const passport = require('passport');
app.use(passport.initialize());
passport.use(new LocalStrategy(
  (username, password, done) => { /* 验证逻辑 */ }
));

文件处理

multer

处理multipart/form-data的中间件，特别适合文件上传：

const multer = require('multer');
const upload = multer({ dest: 'uploads/' });
app.post('/upload', upload.single('avatar'), (req, res) => {
  console.log(req.file); // 上传文件信息
});

sharp

高性能图像处理库，常作为中间件使用：

const sharp = require('sharp');
app.get('/resize', (req, res) => {
  sharp('input.jpg')
    .resize(300, 200)
    .pipe(res);
});

性能优化

compression

响应压缩中间件，支持多种算法：

const compression = require('compression');
app.use(compression({ level: 6 })); // 1-9压缩级别

express-rate-limit

API限流保护：

const rateLimit = require('express-rate-limit');
const limiter = rateLimit({
  windowMs: 15 * 60 * 1000, // 15分钟
  max: 100 // 限制请求数
});
app.use('/api/', limiter);

开发辅助

errorhandler

开发环境错误处理增强工具：

const errorhandler = require('errorhandler');
if (process.env.NODE_ENV === 'development') {
  app.use(errorhandler());
}

swagger-ui-express

API文档自动生成：

const swaggerUi = require('swagger-ui-express');
const swaggerDocument = require('./swagger.json');
app.use('/api-docs', swaggerUi.serve, swaggerUi.setup(swaggerDocument));

数据库集成

connect-redis

Redis会话存储方案：

const session = require('express-session');
const RedisStore = require('connect-redis')(session);
app.use(session({
  store: new RedisStore({ host: 'localhost' }),
  secret: 'keyboard cat'
}));

typeorm-express-middleware

TypeORM集成中间件：

const { createExpressMiddleware } = require('typeorm-express-middleware');
app.use('/data', createExpressMiddleware(connection));

实时通信

express-ws

WebSocket支持扩展：

const expressWs = require('express-ws')(app);
app.ws('/echo', (ws, req) => {
  ws.on('message', msg => ws.send(msg));
});

socket.io

全双工通信解决方案：

const io = require('socket.io')(server);
io.on('connection', socket => {
  socket.on('chat message', msg => {
    io.emit('chat message', msg);
  });
});

微服务集成

express-gateway

API网关中间件：

const gateway = require('express-gateway');
gateway()
  .load(path.join(__dirname, 'config'))
  .run();

express-http-proxy

请求代理中间件：

const proxy = require('express-http-proxy');
app.use('/api', proxy('http://backend-service'));

测试相关

supertest

HTTP断言库，常用于测试中间件：

const request = require('supertest');
request(app)
  .get('/user')
  .expect('Content-Type', /json/)
  .expect(200);

node-mocks-http

模拟HTTP对象用于中间件单元测试：

const httpMocks = require('node-mocks-http');
const mockRequest = httpMocks.createRequest({
  method: 'GET',
  url: '/user'
});