跳转到内容
Jason's Study

Express — Node.js 最经典的 Web 框架

是什么

Express 是 Node.js 上的 Web 框架，让你用几行代码就能写出一个 HTTP 服务器。日常类比：像一条工厂流水线——请求是产品，每个工位（中间件）做一件事，做完喊”下一个”，最后一个工位把产品包装好发出去。

不用 Express 时，你要直接面对 Node.js 原生 http 模块——只给一个 (req, res) 回调，路由要自己 if/else，参数要自己解析，错误处理全靠手撸。Express 把这些抽成一个统一签名：

const express = require('express')
const app = express()
app.get('/hello', (req, res) => res.send('hi'))
app.listen(3000)

四行代码就跑起来了。这就是 Express 2010 年的爆火原因——TJ Holowaychuk 把 Ruby Sinatra 的路由 DSL + Connect 的中间件链思想移植到 Node.js，定义了之后 10 多年 Node.js 服务端的写法。

为什么重要

不理解 Express，下面这些事都没法解释：

  • 为什么你工作的 Node.js 老项目大概率长得都像 Express（即便用的是 Koa / Nest）——它们的 API 形状是 Express 定义的
  • 为什么 Koa / Fastify / Hono 这些”后辈”框架要花大段文档说明”我和 Express 的差异”——它们都是对 Express 的反思
  • 为什么 (req, res, next) 这个三参数签名在所有 Node.js 框架里都眼熟——这是 Connect 中间件协议，Express 让它成事实标准
  • 为什么 weekly downloads 30M+ 的”老古董”还没死——生态、教程、StackOverflow 答案累计太厚，新项目还在用

核心要点

Express 的全部精髓可以拆成 三件事：

  1. 中间件链：所有处理函数都是 (req, res, next) => {}。next() 把控制权交给下一个中间件；next(err) 跳过普通中间件直接进错误处理。类比：流水线传送带，每个工位做完按按钮放下一件。

  2. 路由 = 一种特殊中间件：app.get(path, handler) 相当于”只在请求路径匹配时才执行的中间件”。内部一切都是中间件 + 一个数组（router stack），按注册顺序遍历。

  3. 极简核心 + 可插拔：Express 自身只有 router + 中间件调度。body parsing / cookie / session / CORS / static 全部第三方包（body-parser / cookie-parser / cors / serve-static）。哲学：框架不要多管闲事，把选择权留给用户。

实践案例

案例 1：最小 Express app — 看懂中间件链

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


app.use(express.json())                    // 中间件 1：解析 JSON body
app.use((req, res, next) => {              // 中间件 2：日志
  console.log(`${req.method} ${req.url}`)
  next()                                    // 别忘了调 next！
})


app.get('/users/:id', (req, res) => {      // 路由（也是中间件）
  res.json({ id: req.params.id })
})


app.listen(3000)

请求 GET /users/42 会依次经过 JSON 解析 → 日志 → 路由 handler → res.json 终结。中间件按 app.use 调用顺序执行，谁先注册谁先跑。

案例 2：自定义 logger — 体会 next() 的控制流

function logger(req, res, next) {
  const start = Date.now()
  res.on('finish', () => {                  // 监听响应结束事件
    console.log(`${req.method} ${req.url} ${res.statusCode} ${Date.now() - start}ms`)
  })
  next()                                    // 立刻放行，不等响应
}
app.use(logger)

这里 next() 在 res.on('finish') 之前调——说明 logger 不阻塞流程，只是订阅了”响应完成”事件，等之后真正响应完了再打日志。

案例 3：async handler + 错误传递（v4 vs v5）

v4 写法（必须手动 try/catch）：

app.get('/users/:id', async (req, res, next) => {
  try {
    const user = await db.find(req.params.id)
    if (!user) return res.status(404).json({ error: 'not found' })
    res.json(user)
  } catch (err) {
    next(err)                               // v4 不会自动捕获 async 错误
  }
})


app.use((err, req, res, next) => {          // 错误中间件：4 参数！
  res.status(500).json({ error: err.message })
})

v5 起 async 错误自动传给错误中间件，可以省略 try/catch——这是 v5 最重要的体感升级。

踩过的坑

  1. 忘记调 next()：请求挂起直到客户端超时。新人 #1 bug，老手也偶尔翻车（特别是写带条件分支的中间件时漏掉某个分支的 next）。

  2. 错误中间件必须 4 参数：(err, req, res, next)。少一个参数 Express 把它当普通中间件，错误被吞掉无声无息。Express 用函数 length 属性判断，TypeScript 没法救你。

  3. 中间件顺序 matter：app.use(auth) 写在 app.use('/api', router) 后面，则 /api/* 路由不走鉴权。先注册先执行，没有声明式优先级。

  4. async 在 v4 里要手动 catch：v4 的 (req, res, next) 是 callback 时代设计，async 函数 throw 出去 Express 不接。要么 try/catch + next(err)，要么用 express-async-errors 包打补丁。v5 原生修了，但生态升级慢。

适用 vs 不适用场景

适用：

  • Node.js 入门项目、教学场景——StackOverflow 答案最多
  • 中小型 REST API、传统 SSR 应用、内部工具站
  • 维护已有的 Express 老项目（市场上多数 Node 服务端代码）
  • 需要海量第三方中间件（npm 上几千个 express- 包）

不适用：

  • 极致性能敏感场景（单机 QPS > 5 万）→ 选 Fastify 或 Hono
  • 需要类型安全的 RPC 风格 API → 选 NestJS / tRPC
  • Edge Runtime / Cloudflare Workers → Express 依赖 Node API，跑不动；选 Hono / Itty Router
  • 完整的”全栈框架体验”（路由 + ORM + 队列 + Auth）→ 选 NestJS / RedwoodJS / Next.js

历史小故事（可跳过）

  • 2010-06：TJ Holowaychuk 发布 Express v1，灵感来自 Ruby Sinatra（路由 DSL）+ Connect（中间件链）
  • 2012：v3 发布，引入 view engine、把 Connect 内置中间件直接打包
  • 2014：v4 拆出 router 子包、移除 Connect 内置中间件（推 body-parser 等独立包）；同年 TJ 把项目交给 StrongLoop / IBM，自己离场
  • 2016：项目移交给 OpenJS Foundation TSC 集体维护
  • 2024：v5 RC 发布——10 年没动后终于出大版本：原生 async 错误处理、严格 path-to-regexp、移除若干废弃 API
  • 这是个”技术过气但生态不灭”的范例，类比 jQuery 之于前端

学到什么

  1. 中间件 = 抽象成一个统一签名的函数管线，是 web 框架最普适的设计模式（Rack / WSGI / Connect / Express / Koa 都是这个思想的不同投影）
  2. 极简核心 + 第三方插件 是开源项目活 10 年的关键——核心稳定不动，扩展全交给生态
  3. API 形状会绑架后续 10 年：Express 的 (req, res, next) 签名一锁，整个 Node.js 生态被它定型
  4. 看不懂中间件链就读不懂任何 Node.js 后端代码，这是入行的最低门槛

延伸阅读

关联

  • koa —— 同一作者的下一代框架，用 generator/async 替代 callback
  • fastify —— Trie 路由 + JSON schema JIT，throughput 是 Express 的 ~3 倍
  • hono —— Edge Runtime 时代的 Express，跨 Cloudflare/Deno/Bun
  • sinatra —— Ruby 路由 DSL 鼻祖，Express 直接借鉴
  • nestjs —— 基于 Express（默认）的 TypeScript 全栈框架，加装饰器和 DI
  • fastapi —— Python 的 Express 等价物（路由 + 中间件 + ASGI）
  • axum —— Rust 的”中间件 + 路由”框架，Tower service 思想

反向链接

  • actix-web —— Actix Web — Rust 上长期占据 TechEmpower 榜首的 web 框架
  • apollo-server —— Apollo Server — Node 端 GraphQL 服务端的事实标准
  • aspnetcore —— ASP.NET Core — 微软跨平台 web 框架
  • auth-js —— Auth.js — 让 OAuth 登录和会话存储变成两个抽象
  • axum —— axum — 用 Rust 类型系统当『路由参数表』的 Web 框架
  • bullmq —— BullMQ — Node.js 上的 Redis 任务队列
  • chatwoot —— chatwoot — 把 11 种外部聊天渠道归一到同一张消息表
  • chi —— chi — Go 标准库友好的轻量 HTTP router
  • clack —— Clack — 给 Common Lisp 加一层标准化的 web 服务器接口
  • commander —— commander.js — Node.js CLI 解析的声明式标准
  • django —— Django — 全功能 batteries-included 的 Python web 框架
  • echo —— Echo — 极简高性能 Go 框架，5 行起服务
  • elysia —— Elysia — 长在 Bun 上的极致类型安全 Web 框架
  • fastapi —— FastAPI — 用 Python 类型注解写 API
  • fastify —— Fastify — 让 schema 替你写校验和序列化的 Node.js 框架
  • fiber —— Fiber — 把 Express 写法搬到 Go 上的高性能 web 框架
  • flask —— Flask — 用装饰器把 URL 接到函数上的 Python 微框架
  • framer-motion —— Framer Motion — React 声明式动画
  • gin —— Gin — Go 写 web API 的事实标准框架
  • grape —— Grape — 用 Ruby DSL 专写 REST API 的轻量框架
  • graphql-yoga —— GraphQL Yoga — 跨运行时的轻量 GraphQL 服务器
  • hono —— Hono — 多运行时 Web 框架
  • koa —— Koa — async/await + ctx 对象 + 洋葱模型 的极简 Node.js web 框架
  • ktor —— Ktor — 用 Kotlin DSL 拼出来的异步 Web 框架
  • ky —— ky — 把浏览器自带的 fetch 包成顺手工具
  • laravel —— Laravel — 现代 PHP 全栈框架，Eloquent + Blade + Artisan 三件套
  • librechat —— LibreChat — 让一份聊天 UI 同时连 OpenAI / Anthropic / Google / 本地模型，对话留在自己的服务器
  • litestar —— Litestar — 类型驱动的 ASGI 框架（原 Starlite）
  • msw —— MSW — 让 mock 不改业务代码，在网络层透明拦截
  • nestjs —— NestJS — 把 Angular 思想搬到 Node.js 后端的企业级框架
  • nginx —— nginx — 高性能 Web 服务器
  • nodemailer —— Nodemailer — Node.js 发邮件的事实标准
  • pino —— pino — 日志不该阻塞热路径
  • pocketbase —— PocketBase — 一个 Go 二进制就是完整的后端
  • prom-client —— prom-client — Node 服务暴露监控指标的事实标准 SDK
  • rails —— Ruby on Rails — 约定大于配置的全栈 Web 框架教科书
  • rocket —— Rocket — 用 Rust attribute macro 把路由当函数签名写的 web 框架
  • salvo —— Salvo — 把中间件和处理器统一成一个 Handler trait 的 Rust web 框架
  • sinatra —— Sinatra — 用 Ruby 三行代码起一个 web 服务
  • slim-framework —— Slim — PHP 圈最轻的 web 框架，专给小 API 用
  • socket-io —— Socket.IO — 让浏览器和 Node.js 像打电话一样互相喊事件
  • soketi —— Soketi — 自己跑一台 Pusher，把实时通信费砍到零头
  • spring-boot —— Spring Boot — 用 Auto-configuration 把 Java 后端从 XML 地狱里救出来的事实标准框架
  • starlette —— Starlette — FastAPI 底下那台轻量 ASGI 引擎
  • supertokens —— SuperTokens — 自托管认证框架，把登录方式做成可拼装的 Recipe
  • symfony —— Symfony — 把 PHP 框架拆成 30 个独立组件再拼起来
  • vertx —— Vert.x — Eclipse 出品的 polyglot reactive JVM toolkit，用事件总线 + verticle 把 Node.js 那套搬到多语言