Express.js 中间件使用完全指南：从原理到实践-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00710/article/details/148505937

Express.js 中间件使用完全指南：从原理到实践

expressjs.com 项目地址: https://gitcode.com/gh_mirrors/ex/expressjs.com

什么是 Express 中间件

Express 中间件是 Express 框架的核心概念之一，它本质上是处理 HTTP 请求的函数。这些函数可以访问请求对象 (req)、响应对象 (res) 和应用程序的请求/响应循环中的下一个中间件函数 (next)。

中间件在 Express 应用中扮演着"处理流水线"的角色，每个中间件都可以对请求和响应进行处理，然后决定是结束响应还是传递给下一个中间件。

中间件的基本特性

执行顺序：中间件按照它们在代码中定义的顺序执行
链式调用：通过 next() 函数将控制权传递给下一个中间件
功能多样：可以执行任何代码、修改请求和响应对象、结束请求/响应循环
灵活配置：可以针对特定路径或所有请求应用中间件

中间件的五种类型

1. 应用层中间件

应用层中间件通过 app.use() 和 app.METHOD() 方法绑定到 Express 应用实例上。

基本用法示例：

const express = require('express')
const app = express()

// 无路径中间件，对所有请求生效
app.use((req, res, next) => {
  console.log('请求时间:', Date.now())
  next()
})

// 针对特定路径的中间件
app.use('/user/:id', (req, res, next) => {
  console.log('请求类型:', req.method)
  next()
})

// 处理GET请求的路由中间件
app.get('/user/:id', (req, res, next) => {
  res.send('用户信息')
})

高级技巧：

可以定义中间件数组实现模块化
使用 next('route') 跳过当前路由堆栈中的剩余中间件

2. 路由器层中间件

路由器层中间件与应用层中间件类似，但绑定到 express.Router() 实例。

典型应用场景：

const router = express.Router()

// 路由器级别中间件
router.use((req, res, next) => {
  console.log('请求时间:', Date.now())
  next()
})

// 嵌套中间件堆栈
router.use('/user/:id', 
  (req, res, next) => {
    console.log('请求URL:', req.originalUrl)
    next()
  },
  (req, res, next) => {
    console.log('请求方法:', req.method)
    next()
  }
)

// 将路由器挂载到应用
app.use('/', router)

特殊用法：

使用 next('router') 退出当前路由器实例

3. 错误处理中间件

错误处理中间件专门捕获和处理应用中发生的错误。

关键特征：

必须接受四个参数 (err, req, res, next)
通常放在其他中间件之后

示例代码：

app.use((err, req, res, next) => {
  console.error(err.stack)
  res.status(500).send('服务器错误!')
})

4. 内置中间件

Express 4.x 后仅保留了少量内置中间件：

express.static - 处理静态文件
express.json - 解析 JSON 请求体 (Express 4.16.0+)
express.urlencoded - 解析 URL 编码的请求体 (Express 4.16.0+)

静态文件服务示例：

app.use(express.static('public'))

5. 第三方中间件

Express 生态有丰富的第三方中间件，可以轻松扩展功能。

常用中间件安装使用：

npm install cookie-parser body-parser morgan

const cookieParser = require('cookie-parser')
const bodyParser = require('body-parser')
const morgan = require('morgan')

app.use(cookieParser())
app.use(bodyParser.json())
app.use(morgan('dev'))