集成与功能测试

这一课你将能做到

1. 用一张对照表说清单测 / 集成测试 / 功能（E2E）测试的边界、成本与数量配比
2. 把 Express 应用拆成「可导出的 app + 独立的启动入口」，并用 supertest 写出不占端口的 API 集成测试
3. 落地测试数据库的三种隔离策略（独立测试库 / 事务回滚 / 每轮清理），并搭一个测试专用环境

为什么要学

上一课的单测把每个零件都验过，但零件全对不代表机器能转：路由注册漏了、中间件顺序错了、SQL 写对了但字段映射歪了、缓存键冲突了——这些「拼起来的缝」只有集成测试能抓到。它是后端性价比最高的测试层：比 E2E 快得多，比单测真实得多。

人话：单测像检查每块砖都合格，集成测试像检查砖缝有没有砌歪。功能测试（E2E）则是「找个用户从头走一遍」——浏览器点开、登录、下单全链路。三层各管一段，谁也替代不了谁。

先建立图像

三种测试的分工一图看清：

              被测范围              依赖真实度        速度    数量
单元测试      一个函数/类            全 mock          ms 级   最多
集成测试      路由+服务+真DB/缓存    依赖真实(测试库)  秒级    适中   ← 本课主角
功能/E2E      整个系统含前端         全真实环境        分钟级  最少

典型场景："创建笔记"接口
单测:      validateNote() 校验逻辑对不对
集成测试:  POST /api/notes → 进库 → 返回 201，再 GET 能查到吗
功能测试:  Playwright 开浏览器 → 填表单 → 点提交 → 断言页面出现新笔记

跟着做

步骤 1：先拆 app 与 server——可测试性的第一步

第 7 课的项目把 listen 和路由写在一个文件里，测试没法导入。标准拆法：

mkdir bebg-test-int && cd bebg-test-int && npm init -y && npm install express
npm install -D vitest supertest

package.json 补上 "type": "module" 与 "scripts": { "test": "vitest run" }。

// src/app.js —— 只定义应用，不监听端口（测试可直接导入）
import express from 'express';

const state = { notes: [], nextId: 1 };   // 演示用内存存储，接真库的版本见步骤 3

export function createApp(store = state) {
  const app = express();
  app.use(express.json());

  app.get('/api/notes', (req, res) => {
    res.json({ data: store.notes, total: store.notes.length });
  });

  app.post('/api/notes', (req, res) => {
    const { title } = req.body || {};
    if (!title?.trim()) return res.status(400).json({ error: 'title 必填' });
    const note = { id: store.nextId++, title: title.trim() };
    store.notes.push(note);
    res.status(201).json(note);
  });

  app.delete('/api/notes/:id', (req, res) => {
    const i = store.notes.findIndex(n => n.id === Number(req.params.id));
    if (i === -1) return res.status(404).json({ error: '笔记不存在' });
    store.notes.splice(i, 1);
    res.status(204).end();
  });

  return app;
}

// src/server.js —— 真正启动时才监听
import { createApp } from './app.js';

createApp().listen(3000, () => console.log('http://localhost:3000'));