Node.js项目中Jest单元与集成测试的Prisma适配策略咨询

1. 用文件名后缀区分测试类型 #

给单元测试和集成测试文件加上明确后缀，让Jest能精准识别：

• 单元测试：*.unit.test.js（如 user.service.unit.test.js）
• 集成测试：*.integration.test.js（如 user.route.integration.test.js）

2. 拆分Jest配置为多项目模式 #

修改jest.config.js，通过projects字段分别配置两种测试的独立环境，彻底隔离Mock与真实数据库：

module.exports = {
  projects: [
    {
      displayName: 'unit',
      testMatch: ['**/*.unit.test.js'],
      setupFilesAfterEnv: ['./jest.unit.setup.js'],
      testTimeout: 5000,
    },
    {
      displayName: 'integration',
      testMatch: ['**/*.integration.test.js'],
      setupFilesAfterEnv: ['./jest.integration.setup.js'],
      // 数据库操作耗时更长，放宽超时限制
      testTimeout: 10000,
    },
  ],
};

3. 分别编写测试环境初始化文件 #

单元测试初始化（jest.unit.setup.js） #

在这里配置全局Prisma Mock，沿用你之前的Mock逻辑即可：

const { PrismaClient } = require('@prisma/client');

jest.mock('@prisma/client', () => {
  // 自定义你的Mock Prisma Client实现
  const mockPrisma = {
    user: {
      findMany: jest.fn().mockResolvedValue([]),
      create: jest.fn().mockResolvedValue({ id: 1, name: 'Test User' }),
      // 补充其他需要Mock的模型方法
    },
  };
  return { PrismaClient: jest.fn(() => mockPrisma) };
});

集成测试初始化（jest.integration.setup.js） #

这里配置真实测试数据库的连接、初始化与数据清理，避免测试间污染：

// 加载测试环境变量，与开发数据库隔离
require('dotenv').config({ path: '.env.test' });
const { PrismaClient } = require('@prisma/client');
const prisma = new PrismaClient();

// 测试前确保数据库结构最新（可执行迁移或手动初始化）
beforeAll(async () => {
  await prisma.$executeRawUnsafe('TRUNCATE TABLE "User" RESTART IDENTITY CASCADE;');
});

// 每个测试后清空数据，保证测试独立性
beforeEach(async () => {
  await prisma.$executeRawUnsafe('TRUNCATE TABLE "User" RESTART IDENTITY CASCADE;');
});

// 测试结束断开数据库连接
afterAll(async () => {
  await prisma.$disconnect();
});

4. 配置测试数据库环境 #

创建.env.test文件，单独配置测试数据库的连接字符串，完全隔离开发与测试数据：

DATABASE_URL="postgresql://your_user:your_password@localhost:5432/your_test_db"

5. 运行测试 #

• 同时监控所有测试：jest --watch（Jest会自动识别两个项目，可选择运行指定类型）
• 仅运行单元测试：jest --watch --selectProjects unit
• 仅运行集成测试：jest --watch --selectProjects integration

替代方案：单配置下的Mock控制 #

如果不想拆分Jest配置，可在测试文件中手动控制Mock状态，但稳定性略差：

• 单元测试文件开头添加：jest.mock('@prisma/client');，并在文件内定义Mock实现
• 集成测试文件开头添加：jest.unmock('@prisma/client');，强制使用真实Prisma Client

内容的提问来源于stack exchange，提问作者Andreas Remdt