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

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)
})

最佳实践建议

逐步迁移：大型应用建议分模块逐步迁移
测试覆盖：确保有充分的测试用例覆盖核心功能
中间件顺序：注意 Express 4 中中间件顺序的重要性
错误处理：确保错误处理中间件位于所有路由之后
性能监控：迁移后关注应用性能变化

总结

Express 4 的架构改进使框架更加模块化和灵活，虽然迁移过程需要一定的工作量，但带来的长期收益是值得的。通过本文的指南，开发者可以系统地完成从 Express 3 到 Express 4 的迁移，并充分利用新版本提供的各项改进。

记住，迁移不仅是简单的 API 替换，更是对应用架构进行优化的好机会。在迁移过程中，考虑重构路由组织、优化中间件使用，可以使应用获得更好的可维护性和性能。

【免费下载链接】expressjs.com 项目地址: https://gitcode.com/gh_mirrors/ex/expressjs.com

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考