Express.js 4.x 迁移指南：从 Express 3 升级到 Express 4

Express.js 4.x 迁移指南：从 Express 3 升级到 Express 4

概述

Express 4 是 Express 框架的一个重要版本升级，与 Express 3 存在不兼容的变更。这意味着如果你直接将项目中的 Express 依赖从 3.x 升级到 4.x，现有的应用程序将无法正常工作。

本文将全面解析 Express 4 的主要变化，并通过实际示例演示如何将 Express 3 应用迁移到 Express 4。

Express 4 的核心变化

1. 中间件系统的重构

Express 4 最大的变化之一是不再依赖 Connect，并移除了几乎所有内置中间件，只保留了 express.static 函数。这一变化使得 Express 成为一个更加专注于路由和中间件管理的轻量级框架。

中间件迁移对照表

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

迁移时需要：

1. 安装对应的中间件包
2. 在应用中引入模块
3. 按照文档配置中间件

2. 路由系统的增强

Express 4 的路由系统变得更加灵活和模块化：

链式路由定义

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

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

模块化路由

新的 express.Router 类可以创建独立的路由模块：

// birds.js
const router = express.Router()
router.get('/', (req, res) => res.send('Birds home'))
module.exports = router

// 主应用
app.use('/birds', require('./birds'))

3. 其他重要变更

• Node.js 版本要求：最低需要 Node.js 0.10.x，不再支持 0.8.x
• 应用启动：不再需要显式创建 HTTP 服务器，可直接使用 app.listen()
• 环境配置：移除了 app.configure() 方法，改用 process.env.NODE_ENV
• 参数处理：req.params 从数组改为对象
• 响应头：res.headerSent 改为 res.headersSent

实际迁移示例

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(app.router)
app.use(express.static(__dirname + '/public'))

app.get('/', function(req, res) {
  res.send('Hello World')
})

app.listen(3000)

迁移步骤

1. 更新依赖：

   npm install express@4 body-parser morgan serve-favicon --save
   

2. 重构中间件：

   const express = require('express')
   const favicon = require('serve-favicon')
   const logger = require('morgan')
   const bodyParser = require('body-parser')
   
   const app = express()
   
   app.use(favicon(__dirname + '/public/favicon.ico'))
   app.use(logger('dev'))
   app.use(bodyParser.json())
   app.use(bodyParser.urlencoded({ extended: false }))
   app.use(express.static(__dirname + '/public'))
   

3. 移除 app.router：Express 4 会自动处理路由中间件顺序

4. 更新启动方式（可选）：

   // 更简洁的启动方式
   app.listen(3000, () => {
     console.log('Server started on port 3000')
   })
   

应用生成器的变化

Express 4 的应用生成器已拆分为独立包：

1. 卸载旧生成器：

   npm uninstall -g express
   

2. 安装新生成器：

   npm install -g express-generator
   

新生成器创建的项目结构主要变化：

• 中间件作为独立模块引入
• 应用入口改为 ./bin/www
• app.js 导出 Express 实例而非直接启动应用

最佳实践建议

1. 逐步迁移：对于大型项目，建议逐个路由/中间件进行迁移测试
2. 错误处理：确保错误处理中间件位于所有路由之后
3. 性能监控：利用新的中间件系统实现更精细的性能监控
4. 模块化开发：充分利用 Router 实现功能模块的解耦

通过理解这些核心变化并遵循迁移步骤，开发者可以顺利将应用升级到 Express 4，享受更灵活、更模块化的开发体验。