전체 메뉴

테마

Chapter 19

단위·슬라이스 테스트

Spring 없이 서비스 규칙을 검증하는 JUnit·Mockito 단위 테스트와 웹·영속 계층만 띄우는 @WebMvcTest·@MybatisTest 슬라이스 테스트를 작성하고 경계값과 대표 오류를 확인합니다.

난이도
중급
예상 학습
130분
Spring Boot 기준
Spring Boot 4.1.1
JDK 기준
JDK 21
최종 검토

전체 24개 Chapter 중 Chapter 19입니다. 예제 코드는 공개 저장소 spring-boot-curriculum에서 확인할 수 있습니다.

Learning goals

오늘 배울 내용

  • 단위·슬라이스·통합 테스트를 목적에 따라 선택하기
  • Mockito로 협력 객체를 대체하고 호출 순서와 전달값 검증하기
  • 매개변수 테스트와 변경 실험으로 경계값 검증하기
  • @WebMvcTest로 상태 코드·JSON·검증·예외 매핑 확인하기
  • @MybatisTest로 SQL·제약·롤백 확인하기
  1. 테스트 범위 선택
  2. Mockito 단위 테스트
  3. 호출과 경계 검증
  4. 웹 슬라이스
  5. 영속 슬라이스
  6. 보장 범위 확인
이 Chapter의 진행 흐름

@SpringBootTest 하나로 모든 것을 검사하면 편합니다. 그러나 규칙 하나를 확인하려고 데이터베이스와 메일 서버까지 준비하면 테스트는 느려지고, 실패했을 때 어느 계층의 문제인지도 흐려집니다. 이 Chapter는 필요한 만큼만 띄워서 검사하는 두 가지 방법을 다룹니다.

  • 단위 테스트: 스프링 없이 서비스 규칙만. 협력 객체는 Mockito 목으로 바꿉니다(ch27).
  • 슬라이스 테스트: 웹 계층(@WebMvcTest)과 영속 계층(@MybatisTest)을 각각 따로(ch28).

그리고 이 테스트들이 보장하지 않는 것을 분명히 해서, 다음 Chapter(통합 테스트)가 왜 필요한지 이어 줍니다.

이 Chapter에서 만드는 것

만드는 것 설명
SignupService 테스트 6건 이메일 정규화, 중복 거절, 저장 뒤 메일 발송 등 규칙만 검사
DiscountPolicy 테스트 7건 가입 기간 경계값을 매개변수 테스트로 검사
웹 슬라이스 7건 컨트롤러의 상태 코드, JSON, 검증, 예외 매핑
서비스 테스트 3건 매퍼를 목으로 바꾼 서비스 분기
매퍼 슬라이스 6건 SQL, 생성 id, UNIQUE 제약, 롤백
컨텍스트 1건 전체 설정이 뜨는지

ch27은 13건, ch28은 17건이 모두 통과했습니다.

직접 실행해 확인한 결과

확인 결과
ch27 test 13건 통과(가입 성공 3, 가입 거절 3, DiscountPolicy 7)
ch28 test 17건 통과(웹 슬라이스 7, 매퍼 슬라이스 6, 서비스 3, 컨텍스트 1)
변경 실험 A: toLowerCase() 제거 13건 중 2건 실패(성공 경로 1, 중복 거절 1)
변경 실험 B: years >= 3을 years > 3으로 13건 중 2건 실패(정확히 3년 경계 케이스 1, 시계가 달라지는 테스트 1)

사전 지식

  • 앞 Chapter의 서비스 계층과 사용자 CRUD(컨트롤러, 서비스, MyBatis 매퍼), MockMvc 기본.
  • 코드는 examples/ch27-junit-mockito, examples/ch28-slice-tests입니다.

확인 환경

Docker 컨테이너(JDK 21.0.11), Spring Boot 4.1.1, JUnit Jupiter 6.0.3, Mockito 5.23.0, mybatis-spring-boot-starter-test 4.1.0, H2입니다. 오류 메시지는 일부러 같은 실수를 만들어 실제로 얻은 것이고, 다른 버전에서는 문구가 다를 수 있습니다. 슬라이스 테스트가 더 빠르다는 점은 측정하지 않았습니다. Windows는 확인하지 못했습니다.

예제 코드

대상 링크
ch27 ch27-junit-mockito/
ch28 ch28-slice-tests/
서비스 SignupService.java
서비스 테스트 SignupServiceTests.java
할인 정책 테스트 DiscountPolicyTests.java
웹 테스트 UserControllerWebTests.java
매퍼 테스트 UserMapperSliceTests.java
서비스 테스트 UserServiceTests.java

테스트의 종류와 고르는 법

테스트는 “무엇을 확인하려는가”에 따라 띄우는 범위가 달라집니다. 범위가 클수록 실제와 가깝지만 느리고 실패 원인이 넓습니다. 범위가 작을수록 빠르고 원인이 좁지만, 이어 붙이는 부분은 검사하지 못합니다.

세 가지 범위

종류 띄우는 것 이 Chapter의 예 확인하는 것
단위 스프링 없이 클래스 하나(협력 객체는 목) SignupServiceTests 분기, 규칙, 호출
슬라이스 한 계층에 필요한 빈만 @WebMvcTest, @MybatisTest 요청/응답 모양, SQL
통합 전체 컨텍스트, 실제 협력 객체 Chapter 20 통합 테스트 계층 사이의 연결

무엇을 확인하려는가로 고르기

확인하려는 것 알맞은 테스트
이메일 정규화, 할인율 같은 규칙 단위
잘못된 본문이 400이 되는가, 예외가 409로 바뀌는가 웹 슬라이스
SQL이 맞는가, UNIQUE 제약이 예외가 되는가 영속 슬라이스
요청이 컨트롤러-서비스-DB를 지나 저장되는가 통합

실패했을 때 어디를 볼지도 이 구분이 정해 줍니다. 그 순서는 아래 “세 곳의 테스트가 보장하지 않는 것” 절에서 정리합니다.

이 절의 확인 범위

세 종류의 속도 차이는 이 예제에서 측정하지 않았습니다. “단위가 더 빠르다”는 일반적인 경향이지 이 저장소에서 잰 값이 아닙니다.

따라 하기

./gradlew :examples:ch27-junit-mockito:test :examples:ch28-slice-tests:test

재검증에서 13건과 17건이 모두 통과했습니다. 두 모듈의 테스트 클래스 이름이 각각 단위(SignupServiceTests), 웹 슬라이스(UserControllerWebTests), 영속 슬라이스(UserMapperSliceTests)로 나뉘는 것을 확인해 보세요.

자주 하는 실수

실수 증상 해결
모든 테스트를 @SpringBootTest로 작성 규칙 하나를 확인하려고 전체를 띄움 확인 대상에 맞는 범위 선택
단위 테스트만으로 연결까지 검증됐다고 판단 이음새 버그를 놓침 통합 테스트로 보완
속도 차이를 숫자 없이 단정 근거 없는 주장 필요하면 직접 측정

확인 문제

  1. “SQL이 맞는가”를 확인하기에 알맞은 테스트는 무엇인가요?
  2. 범위를 좁힐수록 얻는 것과 잃는 것은 무엇인가요?

답: 1) 영속 슬라이스(@MybatisTest)입니다. 2) 빠르고 원인이 좁아지지만 계층 사이의 연결은 볼 수 없습니다.

직접 해 보기

  1. 자신의 프로젝트에서 기존 테스트 3개를 골라 위 세 종류로 분류해 보세요.
  2. 가장 느린 테스트가 정말 그 범위가 필요한지 따져 보세요.
  3. 이 표에 없는 확인 대상(예: 인증)을 어느 종류로 할지 적어 보세요. (Chapter 21에서 다룹니다.)

스프링 없이 서비스 규칙만 테스트하기

가입 서비스에 “이메일은 소문자로 저장하고, 중복이면 거절하고, 저장이 끝난 뒤에만 환영 메일을 보낸다”는 규칙이 있다고 합시다. 이 규칙을 확인하려고 매번 스프링을 띄우고 DB와 메일 서버까지 준비하면 테스트는 금방 느려지고 멀어집니다. 협력 객체를 Mockito 목으로 바꿔 서비스의 규칙만 검사합니다.

대상 서비스

public class SignupService {

    private final UserRepository repository;
    private final MailSender mailSender;
    private final Clock clock;

    public SignupService(UserRepository repository, MailSender mailSender, Clock clock) { ... }

    public User signup(String name, String email) {
        if (name == null || name.isBlank()) {
            throw new IllegalArgumentException("이름은 비어 있을 수 없습니다");
        }
        String normalized = email.trim().toLowerCase();
        if (repository.existsByEmail(normalized)) {
            throw new DuplicateEmailException(normalized);
        }
        User saved = repository.save(name, normalized, LocalDate.now(clock));
        mailSender.sendWelcome(saved.email(), saved.name());
        return saved;
    }
}

스프링 애노테이션이 하나도 없는 평범한 클래스입니다. 협력 객체(UserRepository, MailSender)가 인터페이스이고 생성자로 들어오기 때문에, 테스트에서는 아무 구현이나 끼울 수 있습니다(Chapter 03의 DI 이점이 테스트에서 드러납니다).

테스트 틀

@ExtendWith(MockitoExtension.class)
class SignupServiceTests {

    @Mock UserRepository repository;
    @Mock MailSender mailSender;

    SignupService service;

    @BeforeEach
    void setUp() {
        service = new SignupService(repository, mailSender, TODAY);
    }
}

@ExtendWith(MockitoExtension.class)가 @Mock 필드에 목을 만들어 넣습니다. 이 확장은 엄격 모드로 동작하는데, 쓰이지 않은 stub이나 인자가 어긋난 stub을 실패로 처리합니다(아래 “경계값 테스트와 틀리게 고쳐 보기”와 “Mockito에서 자주 만나는 오류” 절).

값을 정하고, 호출을 확인한다

given(repository.existsByEmail("kim@example.com")).willReturn(false);
given(repository.save("kim", "kim@example.com", LocalDate.parse("2026-10-17")))
        .willReturn(new User(1, "kim", "kim@example.com", LocalDate.parse("2026-10-17")));

User saved = service.signup("kim", "  KIM@Example.com ");

then(mailSender).should().sendWelcome("kim@example.com", "kim");

코드 읽기

  • given(...).willReturn(...): “이 인자로 불리면 이 값을 돌려줘”라는 응답(stub)을 정합니다.
  • 입력은 공백과 대문자가 섞인 " KIM@Example.com "인데 stub은 소문자 값만 받습니다. 서비스가 정규화를 하지 않으면 stub이 맞지 않아 테스트가 실패하므로, 정규화 규칙이 stub 모양에 녹아 있습니다.
  • then(mailSender).should().sendWelcome(...): 환영 메일이 이 값으로 보내졌는지 확인합니다.
  • TODAY는 Clock.fixed로 만든 시계입니다. LocalDate.now(clock)이 항상 같은 날짜(2026-10-17)를 돌려주므로 “오늘”이 언제든 같은 결과입니다. 시스템 시계를 직접 부르는 코드(LocalDate.now())는 이렇게 고정할 수 없어서, 시계를 주입받는 설계가 테스트를 쉽게 합니다.

테스트 6건

SignupServiceTests의 6건이 모두 통과했습니다. 이 절에서는 성공 경로를 봤고, 나머지(중복 거절, 호출 순서, 메일 실패 등)는 이어지는 “호출 순서와 전달값, 그리고 현재 동작 남기기” 절에서 다룹니다.

따라 하기

./gradlew :examples:ch27-junit-mockito:test --tests '*SignupServiceTests*'

가입 성공 3건, 가입 거절 3건이 통과합니다. 스프링 컨테이너가 뜨지 않으므로 테스트가 실행되는 동안 Boot 시작 로그가 나오지 않는 점도 확인해 보세요.

자주 하는 실수

실수 증상 해결
@ExtendWith(MockitoExtension.class) 누락 목이 null이라 NPE 클래스에 확장 선언
서비스가 LocalDate.now()를 직접 호출 날짜 때문에 테스트가 불안정 Clock 주입
stub 입력과 서비스의 정규화가 어긋남 stub이 적용되지 않음 정규화된 값으로 stub

확인 문제

  1. given(...).willReturn(...)과 then(...).should()...의 역할 차이는 무엇인가요?
  2. Clock.fixed를 쓰는 이유는 무엇인가요?

답: 1) 앞은 목의 응답을 정하는 것(stub), 뒤는 호출이 일어났는지 확인하는 것(검증)입니다. 2) 실행 날짜와 무관하게 같은 결과를 얻기 위해서입니다.

직접 해 보기

  1. 서비스의 toLowerCase()를 지우고 이 테스트가 어떻게 실패하는지 읽어 보세요.
  2. Clock.fixed의 날짜를 바꾸면 stub의 어느 값을 같이 바꿔야 하는지 확인하세요.
  3. 자신의 서비스에서 LocalDateTime.now()를 직접 부르는 곳을 찾아 Clock 주입으로 바꿔 보세요.

호출 순서와 전달값, 그리고 현재 동작 남기기

성공 경로만 확인하면 “어떤 일이 일어나지 않아야 하는가”를 놓칩니다. 중복이면 저장도 메일도 없어야 하고, 메일은 저장 뒤에만 가야 합니다. 이 절에서는 호출의 순서와 부재를 확인하는 도구와, 지금의 동작을 명시적으로 남기는 테스트를 다룹니다.

확인 도구

확인하려는 것 도구
메일이 저장 뒤에만 가는가 InOrder (inOrder(repository, mailSender))
메일에 어떤 값이 전달됐는가 ArgumentCaptor
거절된 경우 아무것도 저장·발송되지 않았는가 never(), shouldHaveNoInteractions()

중복 이메일 테스트는 예외가 던져지는 것과 함께 저장소의 save와 메일 발송이 한 번도 호출되지 않았음을 확인합니다. 아무 일도 하지 않았다는 사실을 검사하지 않으면, 거절하면서 몰래 저장해 버리는 버그를 놓칩니다.

현재 동작을 드러내는 테스트

메일 발송이 실패하면 어떻게 될까요? 테스트 mailFailurePropagatesAfterTheUserWasSaved를 쓰고 보니, 예외는 그대로 올라오지만 사용자는 이미 저장된 상태였습니다. 서비스가 메일 실패를 되돌리지 않기 때문입니다.

doThrow(new IllegalStateException("smtp down"))
        .when(mailSender).sendWelcome(anyString(), anyString());

assertThatThrownBy(() -> service.signup("kim", "kim@example.com"))
        .isInstanceOf(IllegalStateException.class)
        .hasMessage("smtp down");

// 저장은 이미 끝났다. 이 서비스는 메일 실패를 되돌리지 않는다.
then(repository).should().save("kim", "kim@example.com", LocalDate.parse("2026-10-17"));

코드 읽기

  • void 메서드에 예외를 던지게 할 때는 given(...)이 아니라 doThrow(...).when(목).메서드(...) 형태를 씁니다. given(mailSender.sendWelcome(...))처럼 쓰면 반환값이 없어서 컴파일부터 되지 않습니다.
  • 마지막 then(repository).should().save(...)가 “저장은 이미 끝났다”는 현재 동작을 고정합니다.

이 동작이 옳은지는 다른 문제입니다. 메일 실패 때 가입을 취소해야 한다면 서비스를 고치고 이 테스트의 기대를 바꿔야 합니다. 중요한 것은 테스트가 “지금은 이렇게 동작한다”를 명시적으로 남겨 둔다는 점입니다. 누군가 동작을 바꾸면 이 테스트가 실패해서, 바뀐 사실을 모르고 지나가지 못합니다. 실제 서비스에서는 이 문제를 트랜잭션과 이벤트로 푸는 경우가 많고, 그 방법은 Chapter 16의 커밋 뒤 이벤트에서 다뤘습니다.

자주 하는 실수

실수 증상 해결
void 메서드에 given(...)으로 예외 지정 컴파일·사용 오류 doThrow(...).when(목).메서드(...)
성공 경로만 테스트 거절 경로에서 몰래 저장해도 통과 never()로 부재 확인
현재 동작을 정답이라고 단정 요구사항과 어긋나도 모름 “현재 동작”임을 이름·주석으로 드러냄

확인 문제

  1. 중복 이메일이면 저장과 메일 발송이 없어야 함을 어떻게 검사하나요?
  2. 메일 발송이 실패한 뒤 저장이 이미 끝났다는 것을 테스트로 고정하는 이유는 무엇인가요?

답: 1) never() 또는 shouldHaveNoInteractions()로 호출이 없음을 확인합니다. 2) 현재 동작을 명시해 두어야 동작이 바뀔 때 눈에 띄기 때문입니다.

직접 해 보기

  1. 중복 이메일 테스트에서 never() 확인을 빼고 서비스에 몰래 save를 넣어 보세요. 테스트가 잡는지 확인하세요.
  2. 메일 실패 시 가입을 취소하도록 서비스를 고치고, 이 테스트의 기대를 어떻게 바꿔야 하는지 적어 보세요.
  3. InOrder로 “저장 뒤 메일” 순서를 검증하는 테스트를 직접 써 보세요.

경계값 테스트와 틀리게 고쳐 보기

테스트가 통과하는 것만으로는 그 테스트가 쓸모 있는지 알 수 없습니다. 이 절에서는 경계값을 빠짐없이 나열하는 방법과, 일부러 코드를 틀리게 고쳐서 테스트가 실패하는지 확인하는 방법을 다룹니다.

경계값 매개변수 테스트

DiscountPolicy는 가입 기간에 따라 할인율을 정합니다(1년 미만 0%, 1년 이상 5%, 3년 이상 10%). 협력 객체가 없는 순수 로직이라 Mockito 없이 값만 바꿔 가며 검사합니다.

@ParameterizedTest(name = "{0}에 가입하면 {1}%")
@CsvSource({
        "2025-10-18, 0",   // 1년이 되기 하루 전
        "2025-10-17, 5",   // 정확히 1년
        "2023-10-18, 5",   // 3년이 되기 하루 전
        "2023-10-17, 10",  // 정확히 3년
})
  • 오늘이 2026-10-17(고정 시계)일 때, 경계의 바로 앞과 바로 뒤를 함께 둡니다. 그래야 >=와 >의 차이가 드러납니다.
  • {0}, {1}은 CSV 열 값으로, 실패 시 어떤 입력이 문제였는지 테스트 이름에 나타납니다.
  • DiscountPolicyTests 7건이 통과했습니다.

틀리게 고쳐서 확인

서비스를 일부러 고쳐 테스트를 돌렸습니다. toLowerCase()를 지우고, 할인 정책의 years >= 3을 years > 3으로 바꾼 두 가지를 한꺼번에 적용했습니다.

틀리게 고친 곳 실패한 테스트
이메일 소문자 변환 제거 성공 경로(savesLowerCasedEmailWithTodayAndSendsWelcome), 중복 거절(duplicateEmailIsRejectedAndNothingIsSavedOrSent)
3년 경계를 >=에서 >로 정확히 3년 경계 매개변수 케이스, 시계 비교 테스트

이 실험에는 아래 “엄격 모드”의 stub 실험이 한 테스트에 섞여 있어서, 실패 건수를 원인별로 나누지는 못했습니다. 당시 기록은 소문자 변환 관련 3건, 경계 관련 2건 실패였지만 stub 실험의 실패가 섞인 값이며, 원본을 복원하자 다시 통과했습니다. 변경별 실패 건수는 아래 “변경 실험을 분리해서 다시 실행한 결과”(각 2건)를 기준으로 합니다. 변경 테스트(mutation testing) 도구는 쓰지 않았고 손으로 두 곳을 바꾼 실험입니다.

엄격 모드

테스트에서 호출되지 않는 인자의 stub을 추가하자 엄격 모드가 막았습니다.

org.mockito.exceptions.misusing.PotentialStubbingProblem:
Strict stubbing argument mismatch. Please check:
 - this invocation of 'existsByEmail' method:
    repository.existsByEmail("lee@example.com");

stub한 인자("zzz")와 실제 호출 인자("lee@example.com")가 달랐다는 알림입니다. 엄격 모드가 없었다면 이 테스트는 조용히 통과했을 것입니다. 쓸모없는 stub이 남은 테스트는 의도한 경로를 달리지 않을 수 있습니다.

변경 실험을 분리해서 다시 실행한 결과

“틀리게 고쳐서 확인”의 표는 두 변경을 한 번에 돌려서 건수를 나누지 못했습니다. 재검증에서 변경 하나씩 복사본에 적용해 각각 test를 실행하고, 실행 뒤 원본으로 되돌렸습니다(저장소에는 반영하지 않았습니다).

변경 결과 실패한 테스트
email.trim().toLowerCase() → email.trim() 13건 중 2건 실패 savesLowerCasedEmailWithTodayAndSendsWelcome(가입 성공), duplicateEmailIsRejectedAndNothingIsSavedOrSent(가입 거절)
years >= 3 → years > 3 13건 중 2건 실패 rateDependsOnMembershipYears의 "2023-10-17"에 가입하면 "10"%, 같은 사용자도 시계가 달라지면 결과가 달라진다

두 번째 변경은 경계 케이스 "2023-10-17"(정확히 3년)이 있어서 잡혔습니다. 이 케이스가 없다면 같은 변경은 통과할 수 있습니다(직접 경계 케이스를 지워서 확인해 보세요).

자주 하는 실수

실수 증상 해결
경계의 바로 앞·뒤를 함께 나열하지 않음 >=와 >의 차이를 못 잡음 경계 앞뒤 값 모두
테스트 통과만으로 충분하다고 판단 쓸모없는 테스트가 남음 코드를 틀리게 고쳐 실패하는지 확인
엄격 모드 경고를 무시하려고 lenient() 남용 쓰지 않는 stub이 쌓임 stub 인자·경로를 바로잡음

확인 문제

  1. 경계값은 @ParameterizedTest로 어떻게 나열하나요?
  2. “통과한 테스트”보다 더 믿을 만한 근거로 이 절이 제시하는 것은 무엇인가요?

답: 1) 경계의 바로 앞과 뒤 값을 @CsvSource로 나열해 같은 테스트를 반복합니다. 2) 코드를 일부러 틀리게 고쳤을 때 테스트가 실패하는지 확인하는 것입니다.

직접 해 보기

  1. >=를 >로 바꾸고 어느 케이스가 실패하는지 확인하세요.
  2. 경계값 케이스를 하나 지우고 같은 변경을 해 보세요. 그 경우 테스트가 통과합니까? (경계 케이스의 가치를 확인하는 실험입니다.)
  3. 자신의 코드에서 >, >= 판단이 있는 곳의 경계값을 나열해 보세요.

Mockito에서 자주 만나는 오류

목을 처음 쓰면 거의 같은 곳에서 막힙니다. 아래는 이 예제에서 일부러 같은 실수를 만들어 실제로 얻은 메시지입니다(메시지는 길어서 앞부분만 옮겼고, 패키지 이름은 줄였습니다). 오류를 일으킨 임시 테스트는 확인 뒤 지웠고 저장소에는 올리지 않았습니다.

1. NullPointerException: 목이 만들어지지 않았다

java.lang.NullPointerException: Cannot invoke "...ch27.UserRepository.existsByEmail(String)" because "this.repository" is null
	at ...ch27.SignupService.signup(SignupService.java:27)

@Mock을 붙였는데 필드가 null입니다. 클래스에 @ExtendWith(MockitoExtension.class)가 없으면 @Mock은 아무 일도 하지 않습니다. 스택 트레이스가 테스트가 아니라 서비스 코드를 가리키기 때문에 서비스 버그로 착각하기 쉽습니다. 메시지의 because "this.repository" is null처럼 null인 것이 목 필드인지를 먼저 봅니다.

2. UnnecessaryStubbingException: 쓰지 않은 stub

org.mockito.exceptions.misusing.UnnecessaryStubbingException:
Unnecessary stubbings detected.
Following stubbings are unnecessary (click to navigate to relevant line of code):
  1. -> at ...ErrorLabTests$Lab.b_unusedStub(ErrorLabTests.java:34)
Please remove unnecessary stubbings or use 'lenient' strictness.

테스트에서 stub을 선언했는데 코드가 그 메서드를 부르지 않았습니다. 이름이 비어 있으면 서비스가 저장소를 부르기 전에 예외를 던지는데, 그 경로의 테스트에 저장소 stub을 남겨 두면 이 오류가 납니다. 오류 줄 번호가 안 쓰인 stub을 정확히 가리키므로 그 줄을 지우면 됩니다. lenient()로 입을 막는 해결은 마지막 수단입니다. 안 쓰이는 stub은 대개 테스트가 의도와 다른 경로를 달리고 있다는 신호입니다.

3. PotentialStubbingProblem: 인자가 다르다

앞의 “경계값 테스트와 틀리게 고쳐 보기” 절의 “엄격 모드”에서 본 오류입니다. stub한 인자와 실제 호출 인자가 다를 때 나옵니다. “오류일 가능성”을 알리는 것이고, 입력이 의도와 달랐는지(대소문자, 공백)를 확인하라는 뜻입니다.

4. InvalidUseOfMatchersException: 값과 매처를 섞었다

given(repository.save("kim", anyString(), any())).willReturn(null);   // 틀림
org.mockito.exceptions.misusing.InvalidUseOfMatchersException:
Invalid use of argument matchers!
3 matchers expected, 2 recorded:
This exception may occur if matchers are combined with raw values:
    //incorrect:
    someMethod(any(), "raw String");
When using matchers, all arguments have to be provided by matchers.

anyString()이나 any() 같은 매처를 하나라도 쓰면 모든 인자를 매처로 줘야 합니다. 정확한 값은 eq("kim")으로 감쌉니다. 인자 3개에 매처가 2개 기록됐다는 숫자만 읽어도 “하나가 값으로 남았다”고 알 수 있습니다.

5. 호출 인자가 달라서 생기는 검증 실패

Argument(s) are different! Wanted:
mailSender.sendWelcome(
    "KIM@example.com",
    "kim"
);
Actual invocations have different arguments at position [0]:
mailSender.sendWelcome(
    "kim@example.com",
    "kim"
);

Wanted가 기대한 호출, Actual이 실제 호출입니다. 서비스가 이메일을 소문자로 바꿔 보내는데 테스트가 원래 입력으로 검증한 경우입니다. 몇 번째 인자(position [0])가 다른지까지 알려 주므로 두 블록을 위아래로 비교하면 됩니다. 테스트를 서비스에 맞춰 고치기 전에 서비스의 동작이 규칙에 맞는지부터 확인합니다.

번외. 서비스에서 난 NullPointerException

java.lang.NullPointerException: Cannot invoke "...ch27.User.email()" because "saved" is null
	at ...ch27.SignupService.signup(SignupService.java:31)

목에 stub하지 않은 메서드는 객체를 반환하는 경우 null을 돌려줍니다(boolean은 false, 컬렉션은 빈 컬렉션). repository.save를 stub하지 않았으니 서비스의 saved가 null이 되어 서비스 코드에서 예외가 납니다. 1번과 증상이 비슷하지만 이쪽은 목은 있고 응답을 정하지 않은 경우입니다.

증상별 점검표

증상 가장 먼저 볼 것
this.repository is null @ExtendWith(MockitoExtension.class) 유무
UnnecessaryStubbingException 오류가 가리키는 stub 줄, 의도한 경로를 타는지
PotentialStubbingProblem stub 인자와 실제 인자 (대소문자, 공백)
InvalidUseOfMatchersException 값과 매처가 섞였는지, 매처 개수
Argument(s) are different! Wanted와 Actual 블록의 차이
서비스 줄에서 NPE 그 목 메서드를 stub했는지

직접 해 보기

  1. 일부러 @ExtendWith를 지우고 1번 오류를 재현해 보세요.
  2. 4번의 코드를 eq("kim")을 쓰도록 고쳐 통과시키세요.
  3. 자신의 테스트에서 lenient()를 쓴 곳이 있다면 정말 필요한지 점검하세요.

웹 슬라이스: @WebMvcTest

컨트롤러의 검증 규칙 하나를 확인하려고 데이터베이스까지 띄울 이유는 없습니다. @WebMvcTest는 컨트롤러와 MVC 설정(검증, 예외 처리)만 만듭니다. 서비스는 @MockitoBean으로 바꿉니다.

테스트 틀

@WebMvcTest(UserController.class)
class UserControllerWebTests {

    @Autowired MockMvc mvc;

    @MockitoBean
    UserService service;
}

슬라이스에 무엇이 들어 있는지 테스트로 확인했습니다.

assertThat(context.getBeanNamesForType(UserController.class)).hasSize(1);
assertThat(context.getBeanNamesForType(UserMapper.class)).isEmpty();

컨트롤러는 있고 매퍼는 없습니다. 웹 슬라이스는 @Service나 @Component 전체를 스캔하지 않고 웹에 필요한 빈만 만들기 때문입니다.

무엇을 검사하는가

웹 슬라이스 7건이 검사하는 것은 상태 코드와 JSON 변환, 검증 오류, 예외 매핑입니다.

상황 기대
잘못된 본문 400, 서비스는 한 번도 불리지 않음(verifyNoInteractions)
서비스가 DuplicateKeyException을 던짐 컨트롤러의 예외 처리가 409와 DUPLICATE_EMAIL로 변환

서비스가 불리지 않았다는 확인이 중요합니다. 검증이 서비스까지 새어 들어가는 버그를 잡습니다.

Boot 4에서 바뀐 이름

항목 Boot 3 Boot 4
@WebMvcTest 패키지 org.springframework.boot.test.autoconfigure.web.servlet org.springframework.boot.webmvc.test.autoconfigure
서비스 대체 @MockBean @MockitoBean (org.springframework.test.context.bean.override.mockito)

Chapter 01에서 본 @AutoConfigureMockMvc의 이동과 같은 이유입니다. 이전 패키지를 복사하면 컴파일이 실패하며(아래 “슬라이스에서 자주 만나는 오류” 절의 2번), 테스트 스타터 spring-boot-starter-webmvc-test도 필요합니다.

따라 하기

./gradlew :examples:ch28-slice-tests:test --tests '*UserControllerWebTests*'

재검증에서 웹 슬라이스 7건이 통과했습니다.

자주 하는 실수

실수 증상 해결
Boot 3의 @MockBean·옛 패키지 사용 컴파일 오류 @MockitoBean, Boot 4 패키지
@MockitoBean을 빠뜨림 Failed to load ApplicationContext 컨트롤러가 쓰는 서비스를 목으로 선언
검증 실패 테스트에서 서비스 호출 여부를 확인하지 않음 검증이 서비스까지 새는 버그를 놓침 verifyNoInteractions

확인 문제

  1. @WebMvcTest에 UserMapper 빈이 없는 이유는 무엇인가요?
  2. 잘못된 본문을 보냈을 때 서비스가 불리지 않았음을 왜 확인하나요?

답: 1) 웹에 필요한 빈만 스캔하기 때문입니다. 2) 검증 규칙이 컨트롤러 입구에서 막아야 하는데 서비스까지 들어가는 버그를 잡기 위해서입니다.

직접 해 보기

  1. @MockitoBean을 지우고 어떤 메시지가 나오는지 읽어 보세요(아래 “슬라이스에서 자주 만나는 오류” 절의 1번).
  2. 서비스의 응답을 given(...)으로 정하고 200과 JSON 필드를 jsonPath로 검사하는 테스트를 하나 써 보세요.
  3. 검증 규칙에 새 조건을 추가하고 400이 되는 케이스를 테스트하세요.

영속 슬라이스와 서비스 테스트

SQL 하나를 확인하려고 웹 서버 설정까지 읽을 필요도 없습니다. @MybatisTest는 DataSource, MyBatis, 매퍼만 띄우고 각 테스트를 트랜잭션 안에서 실행한 뒤 롤백합니다. 이 절에서는 영속 슬라이스와, 스프링 없이 하는 서비스 테스트를 함께 봅니다.

영속 슬라이스

assertThat(context.getBeanNamesForType(UserMapper.class)).hasSize(1);
assertThat(context.getBeanNamesForType(UserService.class)).isEmpty();
assertThat(context.getBeanNamesForType(UserController.class)).isEmpty();

6건이 SQL 쪽을 검사합니다.

검사 내용
초기 데이터 schema.sql, data.sql로 처음 3건이 들어 있음
INSERT 생성된 id가 채워지고 created_at을 읽어 올 수 있음
UNIQUE 제약 같은 이메일을 넣으면 DuplicateKeyException
UPDATE/DELETE 영향받은 행 수를 돌려줌

한 테스트가 행을 지워도 롤백되므로 다른 테스트는 항상 처음 3건을 봅니다. 테스트 순서에 의존하지 않는 것이 핵심입니다.

@MybatisTest를 쓰려면 mybatis-spring-boot-starter-test(4.1.0)를 의존성에 따로 추가해야 합니다.

서비스 테스트: 스프링 없이

서비스 테스트(3건)는 앞의 “스프링 없이 서비스 규칙만 테스트하기” 절과 같은 방식으로 매퍼만 목으로 바꿉니다. create는 INSERT 뒤에 created_at이 객체에 없어서 다시 읽는데, 이를 목으로 흉내 내려면 INSERT가 id를 채워 주는 동작도 흉내 내야 합니다.

given(mapper.insert(any())).willAnswer(invocation -> {
    User u = invocation.getArgument(0);
    u.setId(7L); // MyBatis가 생성된 id를 채워 주는 동작을 흉내 낸다
    return 1;
});

willAnswer는 호출 인자를 보고 동적으로 동작을 정할 때 씁니다. 다만 이렇게 흉내 내는 동작이 실제 MyBatis와 같다는 보장은 없으므로(아래 “세 곳의 테스트가 보장하지 않는 것” 절), 같은 동작을 매퍼 슬라이스가 따로 확인하는 것입니다.

따라 하기

./gradlew :examples:ch28-slice-tests:test --tests '*UserMapperSliceTests*' --tests '*UserServiceTests*'

재검증에서 매퍼 슬라이스 6건과 서비스 테스트 3건이 통과했습니다.

자주 하는 실수

실수 증상 해결
mybatis-spring-boot-starter-test 누락 @MybatisTest를 찾을 수 없음 테스트 의존성 추가
영속 슬라이스에서 UserService 주입 NoSuchBeanDefinitionException 서비스는 슬라이스에 없음(설계대로)
목의 willAnswer가 실제 MyBatis 동작과 다름 단위는 통과, 실제는 실패 실제 동작은 영속·통합 테스트로 확인

확인 문제

  1. 한 테스트가 행을 지워도 다른 테스트가 영향받지 않는 이유는 무엇인가요?
  2. UNIQUE 제약은 어느 슬라이스에서 검사하나요?

답: 1) 각 테스트가 롤백되기 때문입니다. 2) 영속 슬라이스입니다(같은 이메일을 넣으면 DuplicateKeyException).

직접 해 보기

  1. 한 테스트에서 행을 지우고, 다른 테스트가 여전히 3건을 보는지 확인하세요.
  2. UNIQUE 제약 테스트를 지우고 중복 이메일 처리가 어느 계층에서 깨지는지 추적해 보세요.
  3. 슬라이스에서 UserService를 주입받으려 하면 어떤 오류가 나는지 확인하세요(아래 “슬라이스에서 자주 만나는 오류” 절의 1번).

슬라이스에서 자주 만나는 오류

슬라이스 테스트는 “필요한 빈만 띄운다”는 성질 때문에 오히려 빈이 없다는 오류를 자주 만납니다. 아래 메시지는 이 예제에서 같은 실수를 일부러 만들어 얻은 것입니다(긴 메시지는 핵심만 옮겼고 패키지 이름은 줄였습니다). 오류를 일으킨 테스트는 확인 뒤 지웠습니다.

1. 컨텍스트가 뜨지 않는다: 서비스 빈이 없다

@WebMvcTest에서 @MockitoBean을 빠뜨리면 테스트 메서드가 실행되기도 전에 실패합니다.

java.lang.IllegalStateException: Failed to load ApplicationContext for [WebMergedContextConfiguration@... testClass = ...LabMissingMockTests ...]
Caused by: org.springframework.beans.factory.UnsatisfiedDependencyException: Error creating bean with name 'userController' ...: Unsatisfied dependency expressed through constructor parameter 0
Caused by: org.springframework.beans.factory.NoSuchBeanDefinitionException: No qualifying bean of type '...ch28.UserService' available

첫 줄은 “컨텍스트를 못 만들었다”는 결과일 뿐이고, 원인은 맨 아래 Caused by에 있습니다. userController가 필요로 하는 UserService가 없다는 뜻입니다. 웹 슬라이스는 @Service를 만들지 않으므로 @MockitoBean으로 채워야 합니다. 반대로 @MybatisTest에서 서비스를 주입받으려고 하면 같은 계열의 오류가 납니다.

org.springframework.beans.factory.UnsatisfiedDependencyException: Error creating bean with name '...LabMapperWithServiceTests':
Unsatisfied dependency expressed through field 'service': No qualifying bean of type '...ch28.UserService' available

이때는 슬라이스 범위가 의도대로 동작한 것입니다. 서비스가 필요하면 그 테스트는 슬라이스가 아니라 통합 테스트로 옮깁니다. @Import로 서비스를 끼워 넣을 수도 있지만 슬라이스의 의미가 흐려집니다.

2. Boot 3에서 쓰던 import가 컴파일되지 않는다

import org.springframework.boot.test.autoconfigure.web.servlet.WebMvcTest;
import org.springframework.boot.test.mock.mockito.MockBean;
error: package org.springframework.boot.test.autoconfigure.web.servlet does not exist
error: package org.springframework.boot.test.mock.mockito does not exist
error: cannot find symbol
  symbol: class WebMvcTest

Boot 4에서는 @WebMvcTest가 org.springframework.boot.webmvc.test.autoconfigure로 옮겨졌고, @MockBean은 @MockitoBean으로 대체됐습니다. 인터넷의 예제는 대부분 이전 패키지를 쓰므로 복사하면 이 오류를 만납니다. 컴파일이 실패하면 새 패키지로 바꾸고 spring-boot-starter-webmvc-test 의존성이 있는지도 봅니다.

3. 목이 비어 있는데 상태 코드가 예상과 다르다

@MockitoBean으로 만든 서비스에 아무 stub도 하지 않으면, 컨트롤러는 목이 돌려주는 기본값을 받습니다.

// GET /users/1, 서비스를 stub하지 않고 200을 기대
java.lang.AssertionError: Status expected:<200> but was:<404>

findById의 반환 타입이 Optional이라 Mockito가 Optional.empty()를 돌려주고, 컨트롤러는 이를 404로 바꿉니다. 컨트롤러가 틀린 것이 아니라 테스트가 서비스의 응답을 정하지 않은 것입니다. 객체를 반환하는 메서드에서는 다른 증상이 나옵니다.

// POST /users, create를 stub하지 않음
jakarta.servlet.ServletException: Request processing failed: java.lang.NullPointerException:
Cannot invoke "...ch28.User.getId()" because "created" is null

서비스 목이 null을 돌려줬고, 컨트롤러가 created.getId()를 부르다 실패했습니다. 두 경우 모두 given(service....)로 응답을 정하면 사라집니다.

4. JSON을 보냈는데 415가 나온다

java.lang.AssertionError: Status expected:<201> but was:<415>

post("/users").content("{...}")처럼 본문만 넣고 contentType(MediaType.APPLICATION_JSON)을 빠뜨리면 컨트롤러에 닿기 전에 415(지원하지 않는 미디어 타입)가 됩니다. 검증 오류를 기대한 400이 아니라 415가 나오면 먼저 요청 헤더를 의심합니다.

증상별 점검표

증상 가장 먼저 볼 것
Failed to load ApplicationContext 맨 아래 Caused by의 빈 이름, 슬라이스에 그 빈이 있는지
package ... does not exist (테스트 import) Boot 4의 새 패키지와 *-test 의존성
예상과 다른 404/NPE 목을 stub했는지 (Optional은 empty, 객체는 null)
400 대신 415 contentType(APPLICATION_JSON)

직접 해 보기

  1. 1번 오류를 재현하고 Caused by 세 줄 중 어느 줄이 진짜 원인인지 표시해 보세요.
  2. 3번의 Optional.empty()와 null 차이를 설명해 보세요.
  3. contentType을 빼고 415를 재현한 뒤 추가해 201로 고쳐 보세요.

세 곳의 테스트가 보장하지 않는 것

테스트를 계층별로 나누고 나면 실패했을 때 어디를 볼지 정해집니다. 하지만 동시에 계층 사이를 잇는 부분은 어느 테스트도 보지 않는다는 사실이 분명해집니다. 이 절에서는 그 한계를 정리하고, Chapter 20 통합 테스트로 잇습니다.

보장하는 것과 못 하는 것

테스트 보장하는 것 보장하지 않는 것
웹 요청/응답 모양, 검증, 예외 매핑 서비스와 SQL이 실제로 이어지는지
서비스 분기와 호출 SQL이 맞는지
매퍼 SQL과 제약 HTTP 응답

웹 테스트가 모두 통과해도 서비스가 매퍼를 부르는 방식이 틀렸을 수 있고, 매퍼 테스트가 통과해도 서비스가 엉뚱한 인자를 넘길 수 있습니다. 목이 돌려주는 값은 테스트를 쓴 사람의 가정이기 때문입니다. “슬라이스에서 자주 만나는 오류” 절의 3번에서 본 것처럼 목은 Optional.empty()나 null을 아무렇지 않게 돌려주므로, 목으로 이어 붙인 계층 사이에서는 실제 객체가 주고받는 계약이 검증되지 않습니다.

실패했을 때 보는 순서

  1. 매퍼 슬라이스가 실패하면 SQL, 스키마, 제약부터 봅니다.
  2. 서비스 테스트가 실패하면 분기와 호출 인자를 봅니다.
  3. 웹 슬라이스가 실패하면 요청 헤더, 검증 규칙, 예외 매핑을 봅니다.
  4. 셋 다 통과하는데 실제 요청이 실패하면 계층 사이의 연결이므로 통합 테스트를 쓸 차례입니다.

한계

항목 상태
슬라이스 테스트의 속도 이점 측정하지 않음
JPA 슬라이스 다루지 않음
인증이 필요한 웹 슬라이스 검사하지 않음 (Chapter 21)
변경 테스트(mutation) 도구 쓰지 않음. 손으로 고친 실험뿐
목이 많은 테스트의 구현 결합 협력 객체가 둘뿐이라 체감하기 어려움

자주 하는 실수

실수 증상 해결
슬라이스 테스트 통과를 “전체가 동작한다”로 판단 연결 버그를 배포 후 발견 통합 테스트 병행
실패 시 어느 계층을 볼지 정해 두지 않음 원인 추적이 길어짐 매퍼 → 서비스 → 웹 → 통합 순서

확인 문제

  1. 웹, 서비스, 매퍼 테스트가 모두 통과해도 실제 요청이 실패할 수 있는 이유는 무엇인가요?
  2. 셋 다 통과하는데 요청이 실패하면 어느 테스트로 넘어가야 하나요?

답: 1) 목으로 이어 붙인 이음새(계층 사이의 연결)는 검증하지 않았기 때문입니다. 2) 통합 테스트입니다.

직접 해 보기

  1. 자신의 테스트에서 “목으로 연결된 이음새”가 어디인지 표시해 보세요.
  2. 서비스가 매퍼에 엉뚱한 인자를 넘기는 버그를 넣고 어느 테스트가 잡는지 확인하세요.
  3. 이 세 테스트 중 하나를 통합 테스트로 바꿔야 한다면 어느 것인지 이유와 함께 적어 보세요.

용어와 참고 자료

Chapter 19의 용어를 모았습니다. MockMvc는 Chapter 01 용어 정리에서 설명했습니다.

용어

용어 설명 나온 곳
단위 테스트 스프링 없이 클래스 하나를 검사하는 테스트입니다. 테스트의 종류와 고르는 법
슬라이스 테스트 한 계층에 필요한 빈만 띄워 검사하는 테스트입니다. 테스트의 종류와 고르는 법
통합 테스트 전체 컨텍스트와 실제 협력 객체로 계층 연결을 검사하는 테스트입니다. 테스트의 종류와 고르는 법
목(mock) 협력 객체를 대신해 호출을 기록하고 정해진 값을 돌려주는 테스트용 객체입니다. 스프링 없이 서비스 규칙만 테스트하기
stub 목에 “이 인자로 불리면 이 값을 돌려줘”라고 정해 둔 응답입니다. 스프링 없이 서비스 규칙만 테스트하기
엄격 모드(strict stubs) 쓰이지 않거나 인자가 어긋난 stub을 실패로 처리하는 Mockito의 기본 동작입니다. 경계값 테스트와 틀리게 고쳐 보기
Clock 현재 시각을 외부에서 주입할 수 있게 하는 자바 표준 클래스입니다. 스프링 없이 서비스 규칙만 테스트하기
InOrder 목 호출의 순서를 검증하는 Mockito 도구입니다. 호출 순서와 전달값, 그리고 현재 동작 남기기
ArgumentCaptor 목에 전달된 인자를 붙잡아 검사하는 도구입니다. 호출 순서와 전달값, 그리고 현재 동작 남기기
경계값 규칙이 바뀌는 지점의 바로 앞과 바로 뒤 값입니다. 경계값 테스트와 틀리게 고쳐 보기
변경 테스트(mutation testing) 코드를 일부러 틀리게 바꿔 테스트가 잡는지 보는 기법입니다. 경계값 테스트와 틀리게 고쳐 보기
@WebMvcTest 컨트롤러와 MVC 설정만 띄우는 슬라이스 애노테이션입니다. 웹 슬라이스: @WebMvcTest
@MockitoBean 스프링 컨텍스트의 빈을 Mockito 목으로 바꾸는 애노테이션입니다. 웹 슬라이스: @WebMvcTest
@MybatisTest 매퍼와 DB만 띄우고 테스트마다 롤백하는 슬라이스 애노테이션입니다. 영속 슬라이스와 서비스 테스트
롤백 테스트가 끝나면 그 안에서 한 데이터 변경을 되돌리는 것입니다. 영속 슬라이스와 서비스 테스트
UNIQUE 제약 같은 값이 두 번 들어가지 못하게 하는 DB 규칙입니다. 영속 슬라이스와 서비스 테스트

참고 자료

직접 해보기

  1. ./gradlew :examples:ch27-junit-mockito:test :examples:ch28-slice-tests:test로 두 모듈을 실행하고, 테스트 클래스가 단위(SignupServiceTests), 웹 슬라이스(UserControllerWebTests), 영속 슬라이스(UserMapperSliceTests)로 나뉘는 것을 확인해 보세요. 자신의 프로젝트에서도 테스트 3개를 골라 같은 기준으로 분류해 봅니다.
  2. SignupService의 toLowerCase()를 지우고 ./gradlew :examples:ch27-junit-mockito:test --tests '*SignupServiceTests*'를 실행해 어떤 테스트가 실패하는지 읽어 보세요. 실패 메시지가 “Mockito에서 자주 만나는 오류”의 점검표에서 어느 증상에 해당하는지 찾은 뒤 되돌립니다.
  3. DiscountPolicy의 years >= 3을 years > 3으로 바꿔 정확히 3년 케이스(2023-10-17)가 이 변경을 잡는지 확인하고, 그 경계 케이스를 지운 뒤 같은 변경을 다시 해 보세요. 경계의 바로 앞과 바로 뒤를 함께 나열해야 하는 이유를 설명할 수 있으면 됩니다.
  4. UserControllerWebTests에서 @MockitoBean을 지우고 ./gradlew :examples:ch28-slice-tests:test --tests '*UserControllerWebTests*'를 실행해 맨 아래 Caused by에서 없는 빈 이름을 찾아보세요. 되돌린 뒤 contentType(MediaType.APPLICATION_JSON)을 빼서 400이 아니라 415가 나오는지도 확인합니다.
  5. ./gradlew :examples:ch28-slice-tests:test --tests '*UserMapperSliceTests*' --tests '*UserServiceTests*'를 실행하고, 한 테스트가 행을 지워도 다른 테스트가 처음 3건을 보는 이유를 롤백으로 설명해 보세요. 웹, 서비스, 매퍼 테스트가 모두 통과해도 잡지 못하는 버그를 하나 적어 봅니다.

이번 장의 정리

  • 테스트는 확인하려는 대상에 따라 단위, 슬라이스, 통합 중에서 띄우는 범위를 고릅니다. 범위가 작을수록 원인이 좁아지지만 계층 사이의 연결은 볼 수 없습니다.
  • 단위 테스트는 @ExtendWith(MockitoExtension.class)와 @Mock으로 협력 객체를 바꾸고, given(...)으로 응답을 정한 뒤 then(...).should()로 호출을 확인합니다. 날짜는 Clock.fixed로 고정합니다.
  • InOrder, ArgumentCaptor, never()로 호출 순서와 전달값, 일어나지 않아야 할 호출까지 검사하고, 메일 실패 뒤에도 저장이 남는 현재 동작을 테스트로 명시해 둡니다.
  • 경계값은 바로 앞과 바로 뒤를 @CsvSource로 함께 나열하고, 코드를 일부러 틀리게 고쳐 테스트가 실패하는지 확인합니다. 변경을 하나씩 나눠 실행했을 때 두 변경 모두 13건 중 2건이 실패했습니다.
  • Mockito 오류는 this.repository is null, UnnecessaryStubbingException, PotentialStubbingProblem, InvalidUseOfMatchersException, Argument(s) are different!처럼 메시지의 핵심 단어로 원인을 가릅니다.
  • @WebMvcTest는 컨트롤러와 MVC 설정만 띄우고 서비스는 @MockitoBean으로 바꿉니다. Boot 4에서는 패키지가 org.springframework.boot.webmvc.test.autoconfigure로 옮겨졌고 @MockBean은 @MockitoBean으로 대체됐습니다.
  • @MybatisTest는 DataSource, MyBatis, 매퍼만 띄우고 테스트마다 롤백하므로, SQL과 UNIQUE 제약을 테스트 순서에 기대지 않고 검사합니다.
  • 슬라이스 오류는 맨 아래 Caused by부터 읽습니다. 목으로 이어 붙인 계층 사이의 연결은 어느 슬라이스도 보장하지 않으므로 통합 테스트로 채웁니다.

다음 Chapter 20 통합 테스트에서는 진짜 서버를 임의 포트에 띄워 계층이 실제로 이어진 흐름을 검사하고, Testcontainers로 PostgreSQL에서도 같은 SQL이 도는지 확인합니다.

FAQ

자주 묻는 질문

모든 테스트를 @SpringBootTest로 작성하면 안 되나요?

가능하지만 작은 규칙 하나를 확인할 때도 전체 컨텍스트와 외부 자원을 준비하게 되어 실패 원인이 흐려집니다. 단위·슬라이스·통합 테스트를 보장하려는 범위에 맞춰 나눕니다.

Mockito 목은 무엇을 검증해야 하나요?

반환값뿐 아니라 필요한 호출이 있었는지, 순서가 중요한지, 어떤 값이 전달됐는지를 검증합니다. 구현 세부까지 과도하게 묶지는 않습니다.

@WebMvcTest는 서비스 구현도 함께 띄우나요?

기본적으로 웹 계층 중심의 빈만 띄웁니다. 컨트롤러가 의존하는 서비스는 @MockitoBean 등으로 제공해야 합니다.

@MybatisTest의 데이터가 다음 테스트에 남나요?

기본 롤백 경계 안에서 실행되는 슬라이스 테스트라면 각 테스트 뒤 롤백됩니다. 별도 커밋이나 통합 테스트 조건에서는 정리 정책을 따로 확인해야 합니다.

작성·편집 ToolPado

콘텐츠 유형 Spring Boot 학습 가이드

기술 기준 Spring Boot 4.1.1 · JDK 21

마지막 검토