Nestjs项目实战 单元测试与集成测试策略

在NestJS项目中进行单元测试和集成测试时，如何合理规划测试策略？具体想请教：

  1. 单元测试应该覆盖哪些核心模块？比如控制器、服务层、仓储层各自的测试重点是什么？
  2. 集成测试中如何处理外部依赖（如数据库、API调用）？是用jest.mock完全模拟还是使用测试数据库更合适？
  3. 测试覆盖率应该设定到什么程度比较合理？有没有行业内的最佳实践？
  4. 测试代码的组织结构怎样更清晰？是按功能模块划分还是按测试类型划分？
  5. 在CI/CD流程中如何高效运行测试套件？特别是有大量集成测试时如何优化执行速度？

实际项目中经常遇到测试运行慢或维护成本高的问题，想了解大家是如何平衡测试质量和开发效率的？


3 回复

在NestJS项目中，单元测试和集成测试的策略可以这样规划：

单元测试：主要针对服务、控制器和服务提供者等单一模块进行测试。使用Jest作为测试框架，每个函数或方法都应该有独立的单元测试。对于服务层，模拟依赖（如数据库调用）使用Mock对象，确保只测试逻辑本身。例如，对UserService的findUserById方法编写测试，验证其返回值是否正确。

集成测试：侧重于模块之间的交互，比如服务与数据库的交互、控制器与服务的交互。可以通过启动整个应用上下文来执行集成测试，利用Test类创建一个测试实例。例如，测试UserController中的API接口，验证请求参数传递、业务逻辑处理及响应结果是否符合预期。

测试覆盖率建议达到80%以上，优先覆盖核心功能。同时，可以使用持续集成工具（如Jenkins或GitHub Actions）自动运行测试，确保每次代码提交后都能快速发现潜在问题。此外，合理划分测试文件结构，便于后续维护和扩展。


在NestJS项目中，单元测试和集成测试是保证代码质量的关键步骤。

单元测试：专注于测试单一的函数或模块。建议使用Jest作为测试框架，因为它对NestJS有很好的支持。对于服务层的逻辑，比如业务处理、数据验证等，编写独立的单元测试。每个测试应该只测试一个功能点，使用Mock来模拟依赖的服务或库。例如，对于UserService，可以mock掉数据库访问层，单独测试业务逻辑。

集成测试：关注不同模块之间的交互。可以使用supertest库来测试HTTP层的接口。通过发送实际的HTTP请求到应用，验证路由、控制器、服务以及数据库交互是否正常工作。例如，测试用户注册接口时，不仅检查返回的状态码和数据格式，还要确保数据库中的记录正确创建。

总体策略上，先编写全面的单元测试覆盖核心业务逻辑，再进行集成测试验证系统整体协作。保持测试用例的轻量化和高效性，避免冗长复杂的测试脚本。同时，定期运行所有测试，确保任何新添加的功能不会破坏现有功能。

NestJS 项目测试策略指南

单元测试策略

单元测试主要针对单个模块或服务进行隔离测试，使用 Jest 作为测试框架。

核心原则

  • 测试单个类或函数
  • 使用 mock 隔离外部依赖
  • 快速运行

示例：服务单元测试

import { Test, TestingModule } from '@nestjs/testing';
import { UserService } from './user.service';
import { getRepositoryToken } from '@nestjs/typeorm';
import { User } from './user.entity';

describe('UserService', () => {
  let service: UserService;
  
  const mockUserRepository = {
    find: jest.fn().mockResolvedValue([{id: 1, name: 'Test'}]),
    findOne: jest.fn().mockResolvedValue({id: 1, name: 'Test'}),
    save: jest.fn().mockImplementation(user => Promise.resolve(user)),
  };

  beforeEach(async () => {
    const module: TestingModule = await Test.createTestingModule({
      providers: [
        UserService,
        {
          provide: getRepositoryToken(User),
          useValue: mockUserRepository,
        },
      ],
    }).compile();

    service = module.get<UserService>(UserService);
  });

  it('should be defined', () => {
    expect(service).toBeDefined();
  });

  it('should find all users', async () => {
    expect(await service.findAll()).toEqual([{id: 1, name: 'Test'}]);
    expect(mockUserRepository.find).toHaveBeenCalled();
  });
});

集成测试策略

集成测试验证多个模块协同工作的情况。

核心原则

  • 测试模块间的交互
  • 使用真实数据库连接
  • 测试完整的API请求流程

示例：控制器集成测试

import { Test } from '@nestjs/testing';
import { INestApplication } from '@nestjs/common';
import * as request from 'supertest';
import { AppModule } from '../src/app.module';
import { TypeOrmModule } from '@nestjs/typeorm';

describe('UserController (e2e)', () => {
  let app: INestApplication;

  beforeAll(async () => {
    const moduleFixture = await Test.createTestingModule({
      imports: [
        AppModule,
        TypeOrmModule.forRoot({
          type: 'sqlite',
          database: ':memory:',
          entities: [__dirname + '/../**/*.entity{.ts,.js}'],
          synchronize: true,
        }),
      ],
    }).compile();

    app = moduleFixture.createNestApplication();
    await app.init();
  });

  afterAll(async () => {
    await app.close();
  });

  it('/users (GET)', () => {
    return request(app.getHttpServer())
      .get('/users')
      .expect(200)
      .expect([]);
  });

  it('/users (POST)', async () => {
    const response = await request(app.getHttpServer())
      .post('/users')
      .send({ name: 'Test', email: 'test@example.com' })
      .expect(201);

    expect(response.body).toHaveProperty('id');
    expect(response.body.name).toBe('Test');
  });
});

测试策略建议

  1. 测试金字塔：70%单元测试，20%集成测试，10%E2E测试
  2. CI/CD集成：将测试作为CI流水线的必要步骤
  3. 测试覆盖：使用jest --coverage监控测试覆盖率
  4. Mock策略：适度使用mock，集成测试中尽量使用真实服务
  5. 测试数据库：使用内存数据库或docker容器

在NestJS中，充分利用其依赖注入系统可以使测试编写更加简便。

回到顶部