Express 4 迁移指南：从 Express 3 升级到 Express 4 的完整解析-CSDN博客

本文链接：https://blog.csdn.net/gitblog_00896/article/details/148505920

Express 4 迁移指南：从 Express 3 升级到 Express 4 的完整解析

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

前言

Express 作为 Node.js 生态中最流行的 Web 框架之一，其版本 4 带来了许多重大改进和架构调整。本文将深入解析 Express 4 的核心变化，并提供详细的迁移指南，帮助开发者顺利完成从 Express 3 到 Express 4 的过渡。

Express 4 核心变化概述

Express 4 是一个重大的架构升级，主要带来了以下关键变化：

中间件系统重构：移除了对 Connect 的依赖，内置中间件被独立为单独模块
路由系统增强：引入了更灵活的路由组织方式
API 调整：多项 API 进行了优化和改进

这些变化使得 Express 更加模块化、轻量级，同时也带来了更好的性能和可维护性。

中间件系统的重大变革

内置中间件的独立化

Express 4 最显著的变化是将所有内置中间件从核心中移除（除了 express.static）。这意味着：

Express 现在专注于路由和中间件管理
开发者需要显式安装和引入所需的中间件
中间件更新不再影响 Express 核心

中间件迁移对照表

以下是 Express 3 中间件与 Express 4 对应模块的完整对照：

| Express 3 中间件 | Express 4 替代方案 | |-----------------|-------------------| | express.bodyParser | body-parser + multer | | express.compress | compression | | express.cookieSession | cookie-session | | express.cookieParser | cookie-parser | | express.logger | morgan | | express.session | express-session | | express.favicon | serve-favicon | | express.responseTime | response-time | | express.errorHandler | errorhandler | | express.methodOverride | method-override | | express.timeout | connect-timeout | | express.vhost | vhost | | express.csrf | csurf | | express.directory | serve-index | | express.static | serve-static |

中间件使用新模式

在 Express 4 中，使用中间件需要遵循新的三步模式：

安装模块：npm install --save <module-name>
引入模块：require('module-name')
使用模块：app.use(...)

这种显式的中间件管理方式虽然增加了少量配置工作，但带来了更好的灵活性和可控性。

路由系统的增强

Express 4 对路由系统进行了多项改进，使路由管理更加灵活和模块化。

链式路由定义

新增的 app.route() 方法允许为同一路径创建链式路由处理程序：

app.route('/book')
  .get((req, res) => res.send('Get a book'))
  .post((req, res) => res.send('Add a book'))
  .put((req, res) => res.send('Update the book'))

这种方式减少了路径重复，提高了代码的可读性和维护性。

模块化路由组织

express.Router 类的引入使得路由可以模块化组织：

// birds.js
const router = require('express').Router()

router.use((req, res, next) => {
  console.log('Time: ', Date.now())
  next()
})

router.get('/', (req, res) => res.send('Birds home'))
router.get('/about', (req, res) => res.send('About birds'))

module.exports = router

// app.js
const birds = require('./birds')
app.use('/birds', birds)

这种模式特别适合大型应用的路由组织，可以实现路由的按功能模块划分。

其他重要变更

环境要求变更

最低 Node.js 版本要求提升至 0.10.x
不再支持 Node.js 0.8.x

API 变更

app.configure() 移除：改为使用 process.env.NODE_ENV 或 app.get('env') 检测环境
json spaces 默认禁用：需要显式启用
req.accepted() 系列方法：拆分为更具体的 req.accepts() 等方法
res.locals：从函数变为对象
Cookie 设置：res.setHeader('Set-Cookie') 功能受限，推荐使用 res.cookie()

实际迁移步骤示例

准备工作

备份现有项目
更新 package.json 中的依赖项
安装必要的中间件替代模块

依赖更新命令

npm install serve-favicon morgan method-override express-session body-parser multer errorhandler express@latest pug@latest --save

代码调整要点

移除所有 express.* 中间件引用，替换为对应的独立模块
删除 app.use(app.router) 调用
确保错误处理中间件在路由之后加载
更新已废弃的 API 调用

完整迁移示例

Express 3 应用示例

// Express 3 app.js
var express = require('express')
var app = express()

app.use(express.favicon())
app.use(express.logger('dev'))
app.use(express.bodyParser())
app.use(express.methodOverride())
app.use(app.router)
app.use(express.static(__dirname + '/public'))

迁移后的 Express 4 应用

// Express 4 app.js
var express = require('express')
var favicon = require('serve-favicon')
var logger = require('morgan')
var bodyParser = require('body-parser')
var methodOverride = require('method-override')

var app = express()

app.use(favicon(__dirname + '/public/favicon.ico'))
app.use(logger('dev'))
app.use(bodyParser.json())
app.use(bodyParser.urlencoded({ extended: true }))
app.use(methodOverride())
app.use(express.static(__dirname + '/public'))

应用生成器的变化

Express 4 的应用生成器也进行了更新：

生成器包名从 express 改为 express-generator
移除了 --sessions 和 --jshtml 选项
新增了 --hogan 选项支持 Hogan.js 模板引擎

生成器更新步骤

卸载旧版生成器：npm uninstall -g express
安装新版生成器：npm install -g express-generator
生成新应用：express myapp

迁移后的应用结构变化

Express 4 生成的应用结构有几个显著变化：

启动方式变化：从 node app.js 变为 node ./bin/www
app.js 变为模块：需要通过 ./bin/www 加载
中间件显式引入：所有中间件都需要独立安装和引入

保持 Express 3 风格

如果希望保持 Express 3 的启动方式，可以修改 app.js：

// 移除 module.exports = app;
app.set('port', process.env.PORT || 3000)

var server = app.listen(app.get('port'), () => {
  console.log('Express server listening on port ' + server.address().port)
})