一、核心概念
1. Express 简介
-
Node.js 的 Web 框架，提供 HTTP 服务器封装
-
轻量级但灵活，支持中间件扩展
-
基于路由，支持 RESTful API 和传统 MVC 架构
-
无内置 ORM 或模板引擎，但可集成第三方库
2. 核心对象
-
express()- 创建 Express 应用 -
app(Application 对象) - 管理全局中间件、路由、服务器 -
req(Request 对象) - 封装 HTTP 请求信息 -
res(Response 对象) - 封装 HTTP 响应方法 -
router(Router 对象) - 模块化路由管理
二、核心功能
1. 路由系统
(1) 基本路由
app.METHOD(path, handler) // GET, POST, PUT, DELETE, etc.
app.all(path, handler) // 匹配所有 HTTP 方法
app.route(path) // 链式路由定义(2) 路由参数
app.get('/users/:id', (req, res) => {
const userId = req.params.id; // 获取动态参数
});(3) 查询字符串
app.get('/search', (req, res) => {
const query = req.query.q; // /search?q=express
});(4) 模块化路由 (Router)
const router = express.Router();
router.get('/', (req, res) => { ... });
app.use('/api', router); // 挂载到 /api 路径2. 中间件（Middleware）
(1) 基本概念
-
函数签名：
(req, res, next) => { ... } -
执行顺序：按
app.use()顺序执行 -
作用：修改请求/响应、执行额外逻辑、终止请求
(2) 中间件类型
| 类型 | 示例 | 说明 |
|---|---|---|
| 应用级 | app.use(logger) | 全局中间件 |
| 路由级 | router.use(auth) | 路由专属中间件 |
| 错误处理 | (err, req, res, next) | 捕获错误 |
| 内置 | express.json() | 解析 JSON |
| 第三方 | morgan | 日志记录 |
(3) 常用内置中间件
app.use(express.json()); // 解析 JSON 请求体
app.use(express.urlencoded()); // 解析表单数据
app.use(express.static('public')); // 静态文件服务(4) 自定义中间件示例
const logger = (req, res, next) => {
console.log(`${req.method} ${req.url}`);
next(); // 继续执行后续中间件
};
app.use(logger);3. 请求与响应处理
(1) Request (req) 常用属性/方法
| 属性/方法 | 说明 |
|---|---|
req.params | 路由参数 (/users/:id) |
req.query | 查询参数 (?name=express) |
req.body | 请求体（需 body-parser） |
req.headers | 请求头 |
req.cookies | Cookie（需 cookie-parser） |
(2) Response (res) 常用方法
| 方法 | 说明 |
|---|---|
res.send() | 发送响应（自动设置 Content-Type） |
res.json() | 发送 JSON |
res.status() | 设置状态码 |
res.redirect() | 重定向 |
res.render() | 渲染模板（需模板引擎） |
res.sendFile() | 发送文件 |
res.set() | 设置响应头 |
4. 模板引擎（可选）
(1) 常用引擎
-
EJS（嵌入式 JS）
-
Pug（缩进语法）
-
Handlebars（Mustache 风格）
(2) 配置示例
app.set('views', './views'); // 模板目录
app.set('view engine', 'ejs'); // 使用 EJS
app.get('/', (req, res) => {
res.render('index', { title: 'Express' }); // 渲染模板
});三、高级功能
1. 错误处理
(1) 基本错误处理
app.use((err, req, res, next) => {
console.error(err.stack);
res.status(500).send('Server Error!');
});(2) 异步错误处理
app.get('/', async (req, res, next) => {
try {
await someAsyncOperation();
} catch (err) {
next(err); // 传递给错误处理中间件
}
});2. 静态文件服务
app.use(express.static('public')); // 访问 public/ 目录
app.use('/static', express.static('files')); // 自定义路径3. Cookie & Session 管理
(1) Cookie
const cookieParser = require('cookie-parser');
app.use(cookieParser());
res.cookie('name', 'value', { maxAge: 900000 });
req.cookies.name; // 读取 Cookie(2) Session
const session = require('express-session');
app.use(session({ secret: 'keyboard cat', resave: false }));
req.session.user = { name: 'John' }; // 设置 Session4. 文件上传
const multer = require('multer');
const upload = multer({ dest: 'uploads/' });
app.post('/upload', upload.single('file'), (req, res) => {
console.log(req.file); // 文件信息
});四、安全最佳实践
1. 安全中间件
const helmet = require('helmet');
app.use(helmet()); // 设置安全 HTTP 头2. CORS 处理
const cors = require('cors');
app.use(cors()); // 允许跨域请求3. CSRF 防护
const csrf = require('csurf');
app.use(csrf({ cookie: true }));4. 速率限制
const rateLimit = require('express-rate-limit');
const limiter = rateLimit({ windowMs: 15 * 60 * 1000, max: 100 });
app.use(limiter);五、部署与优化
1. 生产环境配置
-
使用
NODE_ENV=production -
启用压缩 (
compression中间件) -
反向代理（Nginx/Apache）
-
日志管理（
morgan+winston）
2. 进程管理（PM2）
pm2 start app.js --name "express-server" --watch六、总结对比（Express vs Koa vs NestJS）
| 特性 | Express | Koa | NestJS |
|---|---|---|---|
| 中间件模型 | 线性执行 | 洋葱圈 | 模块化 + 依赖注入 |
| 异步处理 | 回调 | async/await | async/await |
| 内置功能 | 较少 | 极少 | 丰富（ORM、微服务等） |
| 适用场景 | 传统 Web 服务 | 轻量级 API | 企业级应用 |
七、学习资源
-
Express 官方文档
-
Express 中间件列表
-
Express 最佳实践
Express 是 Node.js 最流行的 Web 框架，适合快速开发 API 和传统 Web 应用。掌握其核心概念（路由、中间件、请求/响应）后，可结合各种中间件扩展功能。
