Spring Boot에서 테스트 코드 작성하기: 단위 테스트와 통합 테스트, MockMvc 활용법

Spring Boot 애플리케이션 에서 테스트 코드는 필수적인 요소입니다. 테스트는 코드 품질을 보장 하고, 개발자가 코드 변경 시 발생할 수 있는 오류를 조기에 발견 할 수 있도록 도와줍니다. 이번 포스팅에서는 단위 테스트와 통합 테스트의 차이 , @SpringBootTest 와 MockBean 사용법 , 그리고 MockMvc를 활용한 REST API 테스트 방법을 다룹니다.

 

---

 

 

목차

1. 단위 테스트와 통합 테스트의 차이
2. @SpringBootTest와 MockBean 활용법
3. MockMvc로 REST API 테스트하기
4. 테스트 코드의 중요성과 트렌드
5. 테스트 예제 코드와 실행 결과

 

---

 

1. 단위 테스트와 통합 테스트의 차이

테스트 코드는 크게 단위 테스트(Unit Test) 와 통합 테스트(Integration Test) 로 나뉩니다. 이 두 가지 테스트의 목적과 범위를 명확히 이해하고 사용해야 효율적인 테스트 코드 작성 이 가능합니다.

테스트 유형	단위 테스트(Unit Test)	통합 테스트(Integration Test)
범위	개별 메서드나 클래스 테스트	애플리케이션의 여러 컴포넌트 간 상호작용 테스트
속도	매우 빠름	상대적으로 느림
의존성	외부 컴포넌트에 의존하지 않음 (Mock 사용)	데이터베이스나 외부 서비스에 의존
주요 도구	JUnit, Mockito	@SpringBootTest
예시	특정 서비스 메서드가 올바른 값을 반환하는지 테스트	전체 API 요청에 대한 응답 테스트

결론

• 단위 테스트 는 빠르게 코드를 검증하는 데 사용되고, 통합 테스트 는 실제 환경에서 모든 기능이 올바르게 작동하는지 확인 합니다. 두 가지 테스트는 상호보완적이므로 함께 작성하는 것이 좋습니다 .

 

---

 

2. @SpringBootTest와 MockBean 활용법

@SpringBootTest 는 애플리케이션의 모든 컴포넌트 를 로드하여 통합 테스트를 수행할 때 사용됩니다. MockBean 은 외부 의존성을 모의(Mock) 객체로 대체해 테스트 환경을 단순화합니다.

예제: UserService 통합 테스트

 

User.java (엔터티)

package com.example.demo.entity;

import jakarta.persistence.Entity;
import jakarta.persistence.GeneratedValue;
import jakarta.persistence.GenerationType;
import jakarta.persistence.Id;

@Entity
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    private String name;

    // Constructor, Getter, Setter 생략
}

 

UserRepository.java (레포지토리)

package com.example.demo.repository;

import com.example.demo.entity.User;
import org.springframework.data.jpa.repository.JpaRepository;

public interface UserRepository extends JpaRepository<User, Long> {
}

 

UserService.java (서비스 클래스)

package com.example.demo.service;

import com.example.demo.entity.User;
import com.example.demo.repository.UserRepository;
import org.springframework.stereotype.Service;

import java.util.Optional;

@Service
public class UserService {

    private final UserRepository userRepository;

    public UserService(UserRepository userRepository) {
        this.userRepository = userRepository;
    }

    public Optional<User> getUserById(Long id) {
        return userRepository.findById(id);
    }
}

 

UserServiceTest.java (통합 테스트)

package com.example.demo;

import com.example.demo.entity.User;
import com.example.demo.repository.UserRepository;
import com.example.demo.service.UserService;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;

import static org.assertj.core.api.Assertions.assertThat;

@SpringBootTest
public class UserServiceTest {

    @Autowired
    private UserService userService;

    @Autowired
    private UserRepository userRepository;

    @Test
    public void 사용자_조회_테스트() {
        // Given: 사용자 생성
        User user = new User();
        user.setName("홍길동");
        userRepository.save(user);

        // When: 사용자 조회
        User foundUser = userService.getUserById(user.getId()).orElse(null);

        // Then: 검증
        assertThat(foundUser).isNotNull();
        assertThat(foundUser.getName()).isEqualTo("홍길동");
    }
}

 

---

 

3. MockMvc로 REST API 테스트하기

MockMvc 는 스프링 MVC의 HTTP 요청과 응답을 테스트 할 수 있는 도구입니다. 이를 통해 실제 서버를 실행하지 않고도 REST API의 동작을 검증 할 수 있습니다.

예제: REST API 테스트

 

UserController.java (REST API 컨트롤러)

package com.example.demo.controller;

import com.example.demo.entity.User;
import com.example.demo.service.UserService;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RestController;

import java.util.Optional;

@RestController
public class UserController {

    private final UserService userService;

    public UserController(UserService userService) {
        this.userService = userService;
    }

    @GetMapping("/users/{id}")
    public Optional<User> getUserById(@PathVariable Long id) {
        return userService.getUserById(id);
    }
}

 

UserControllerTest.java (API 테스트)

package com.example.demo;

import com.example.demo.entity.User;
import com.example.demo.service.UserService;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.boot.test.mock.mockito.MockBean;
import org.springframework.http.MediaType;
import org.springframework.test.web.servlet.MockMvc;
import org.springframework.test.web.servlet.setup.MockMvcBuilders;

import java.util.Optional;

import static org.mockito.Mockito.when;
import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.*;

@SpringBootTest
public class UserControllerTest {

    private MockMvc mockMvc;

    @Autowired
    private UserController userController;

    @MockBean
    private UserService userService;

    @Test
    public void 사용자_API_테스트() throws Exception {
        // Given: Mock 설정
        User user = new User();
        user.setId(1L);
        user.setName("홍길동");
        when(userService.getUserById(1L)).thenReturn(Optional.of(user));

        mockMvc = MockMvcBuilders.standaloneSetup(userController).build();

        // When & Then: API 호출 및 검증
        mockMvc.perform(get("/users/1")
                        .accept(MediaType.APPLICATION_JSON))
                .andExpect(status().isOk())
                .andExpect(jsonPath("$.name").value("홍길동"));
    }
}

 

---

 

4. 테스트 코드의 중요성과 최신 트렌드

• CI/CD 파이프라인에서 필수적인 역할 : 모든 코드 변경 시 테스트가 자동으로 실행됩니다.
• 테스트 주도 개발(TDD) : 코드를 작성하기 전에 테스트를 먼저 작성하는 방법론입니다.
• 테스트 커버리지 측정 : 얼마나 많은 코드가 테스트되고 있는지를 확인하여 품질을 높입니다.
• Mocking 도구 : 외부 API와의 의존성을 제거하기 위해 Mockito 와 같은 도구를 적극적으로 사용합니다.

 

---

 

관련 링크

JUnit 5 공식 사이트👆

Spring Boot 공식 문서👆

Mockito 공식 문서👆

MockMvc 사용법👆

TDD 개념 소개👆

Spring Boot 통합 테스트 가이드👆

---

FAQ

 

1. 단위 테스트와 통합 테스트는 언제 사용하는 것이 좋나요?

• 단위 테스트는 개별 메서드의 동작 을 검증할 때, 통합 테스트는 전체 기능 간 상호작용 을 확인할 때 사용합니다.

2. MockBean과 Mockito의 차이점은 무엇인가요?

• @MockBean 은 Spring 컨텍스트에 주입되는 의존성을 모의 하고, Mockito는 테스트 클래스 내부에서 객체를 모의 합니다.

3. 통합 테스트가 느린 이유는 무엇인가요?

• 통합 테스트는 전체 애플리케이션을 로드 하고, 데이터베이스나 외부 서비스와의 통신이 포함될 수 있어 느립니다.

4. MockMvc로 비동기 요청을 테스트할 수 있나요?

• 네, MockMvc 는 비동기 요청도 지원합니다. .asyncDispatch() 메서드를 사용해 비동기 결과를 검증할 수 있습니다.

5. 테스트 커버리지란 무엇인가요?

• 테스트 커버리지는 코드의 몇 퍼센트가 테스트되고 있는지를 측정 하는 지표입니다. 높은 테스트 커버리지는 코드 품질을 보장하는 데 도움이 됩니다.

 

---

 

마무리

이번 포스팅에서는 Spring Boot에서 테스트 코드 작성 방법 을 학습했습니다. 단위 테스트와 통합 테스트의 차이점 을 이해하고, MockBean 과 MockMvc 를 활용해 REST API를 테스트하는 방법도 함께 다뤘습니다. 테스트 코드는 프로젝트의 품질과 안정성을 보장 하며, 코드 변경 시 발생할 수 있는 오류를 조기에 발견 하는 중요한 도구입니다.

테스트 코드를 작성하는 습관을 들이면, 코드 유지보수가 쉬워지고 팀워크가 향상됩니다. 특히 CI/CD 파이프라인에서 자동화된 테스트는 배포 전에 문제를 미리 발견 하는 데 중요한 역할을 합니다.

이제 이 가이드를 바탕으로 더 많은 테스트 코드를 작성하고 연습 해보세요. 작은 실습들이 모여 더 나은 개발자 로 성장하는 밑거름이 될 것입니다. 🚀

 

---

 

연습 과제

1. 사용자 생성 API 테스트 를 작성해보세요. (POST 요청 사용)
2. 예외 처리 상황에 대한 테스트 코드 를 작성해보세요. 예: 없는 사용자 조회 시 404 응답
3. 비동기 요청 테스트 를 MockMvc를 사용해 구현해보세요.
4. 테스트 커버리지를 측정해보고, 커버리지 비율을 높여보세요.
5. CI 도구(Jenkins, GitHub Actions) 와 연동해 테스트 자동화 환경을 구축해보세요.

 

---

여러분의 테스트 코드 작성 실력 이 프로젝트의 성공을 결정짓는 중요한 요소가 됩니다. 꾸준한 연습으로 코드 품질을 높이고, 더 나은 애플리케이션을 개발해보세요! 🚀