📌 NestJS 백엔드 개발: 기초부터 실전까지 - NestJS에서 테스트 작성과 TDD 실천

📌 NestJS 백엔드 개발: 기초부터 실전까지 - NestJS에서 테스트 작성과 TDD 실천

서비스의 안정성과 신뢰성을 보장하려면 테스트는 선택이 아닌 필수입니다.
NestJS는 Jest 기반의 테스트 환경을 기본으로 제공하며, 테스트 주도 개발(TDD)을 쉽게 실현할 수 있도록 구성되어 있습니다.
이번 글에서는 유닛 테스트(Unit Test), 통합 테스트(E2E Test), Mocking 전략, TDD 흐름 예제를 다룹니다. 🚀

---

12.1 NestJS에서의 테스트 환경

NestJS는 프로젝트를 생성하면 자동으로 Jest 환경이 설정됩니다.

✅ 기본 테스트 구성 파일들

• jest.config.ts: Jest 설정 파일
• test/app.e2e-spec.ts: 기본 End-to-End 테스트
• 각 모듈마다 *.spec.ts 형태로 유닛 테스트 작성 가능

💡 NestJS CLI는 테스트 코드 생성을 자동화해줍니다.

---

12.2 유닛 테스트 (Unit Test)

유닛 테스트는 서비스나 유틸리티 함수처럼 작은 단위의 로직을 검증하는 테스트입니다.

✅ 서비스 유닛 테스트 예시

📂 users.service.ts

@Injectable()
export class UsersService {
  private users = [{ id: 1, name: 'Alice' }];

  findAll() {
    return this.users;
  }

  findOne(id: number) {
    return this.users.find(user => user.id === id);
  }
}

📂 users.service.spec.ts

import { UsersService } from './users.service';

describe('UsersService', () => {
  let service: UsersService;

  beforeEach(() => {
    service = new UsersService();
  });

  it('should return all users', () => {
    expect(service.findAll()).toHaveLength(1);
  });

  it('should return a user by ID', () => {
    expect(service.findOne(1)).toEqual({ id: 1, name: 'Alice' });
  });
});

✅ beforeEach()를 통해 매 테스트마다 fresh 인스턴스 생성
✅ expect()로 테스트 결과 검증

---

12.3 의존성 주입이 있는 서비스 테스트

반응형

NestJS는 DI 컨테이너를 사용하므로, 테스트에서도 TestingModule을 통해 의존성을 주입해야 합니다.

import { Test, TestingModule } from '@nestjs/testing';
import { UsersService } from './users.service';

describe('UsersService', () => {
  let service: UsersService;

  beforeEach(async () => {
    const module: TestingModule = await Test.createTestingModule({
      providers: [UsersService],
    }).compile();

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

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

💡 NestJS의 Test.createTestingModule을 활용하면 실제 서비스처럼 테스트 구성 가능

---

12.4 컨트롤러 테스트 (Mocking 포함)

📂 users.controller.ts

@Controller('users')
export class UsersController {
  constructor(private readonly usersService: UsersService) {}

  @Get()
  findAll() {
    return this.usersService.findAll();
  }
}

📂 users.controller.spec.ts

describe('UsersController', () => {
  let controller: UsersController;
  let service: UsersService;

  beforeEach(async () => {
    const module = await Test.createTestingModule({
      controllers: [UsersController],
      providers: [
        {
          provide: UsersService,
          useValue: {
            findAll: jest.fn().mockReturnValue([{ id: 1, name: 'MockUser' }]),
          },
        },
      ],
    }).compile();

    controller = module.get<UsersController>(UsersController);
    service = module.get<UsersService>(UsersService);
  });

  it('should return mocked users', () => {
    expect(controller.findAll()).toEqual([{ id: 1, name: 'MockUser' }]);
  });
});

✅ 실제 서비스 대신 mock 객체를 주입
✅ jest.fn()으로 메서드 모킹 및 반환 값 지정

---

12.5 E2E 테스트 (End-to-End)

E2E 테스트는 실제 서버를 실행하고, 전체 흐름을 통합적으로 테스트합니다.

📂 test/app.e2e-spec.ts

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

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

  beforeAll(async () => {
    const moduleFixture = await Test.createTestingModule({
      imports: [AppModule],
    }).compile();

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

  it('/ (GET)', () => {
    return request(app.getHttpServer())
      .get('/')
      .expect(200)
      .expect('Hello World!');
  });
});

✅ supertest를 통해 실제 HTTP 요청을 보내 테스트
✅ app.getHttpServer()로 NestJS 인스턴스 기반 서버 접근

---

12.6 TDD(Test Driven Development) 흐름

TDD는 다음의 순서로 테스트를 기반으로 개발을 진행합니다:

1. Fail: 먼저 실패하는 테스트를 작성
2. Pass: 테스트가 통과하도록 최소한의 코드 작성
3. Refactor: 테스트가 통과된 상태에서 리팩토링

💡 테스트 코드를 먼저 작성하면 요구사항에 맞춘 안정적인 코드 구현 가능

---

12.7 테스트 실행 및 커버리지 확인

✅ 테스트 실행

npm run test

✅ 테스트 커버리지 확인

npm run test:cov

출력 예시:

File                   | % Stmts | % Branch | % Funcs | % Lines |
-----------------------|---------|----------|---------|---------|
src/users/users.service.ts |   100% |      100% |   100% |   100% |

💡 커버리지 도구를 통해 테스트 범위를 시각적으로 확인 가능

---

12.8 결론: NestJS 테스트와 TDD로 신뢰성 있는 코드 만들기

✅ NestJS는 Jest 기반의 유닛 & 통합 테스트 환경을 기본 제공
✅ TestingModule로 DI 주입 테스트 가능
✅ 서비스, 컨트롤러, E2E 테스트까지 완전한 테스트 체계 구축 가능
✅ TDD 방식으로 개발 시 안정성과 유지보수성이 대폭 향상됨

다음 글에서는 NestJS 프로젝트의 구조 정리와 모노레포(Monorepo) 패턴 적용법을 소개합니다! 🚀

---

🔍 다음 글 예고: NestJS 프로젝트 구조 정리 및 모노레포 구성 전략

📌 다음 편: 13. NestJS 모노레포 구조와 실전 적용법