Chapter 19의 슬라이스 테스트가 모두 통과해도 아직 알 수 없는 것이 있습니다. 계층이 실제로 이어졌을 때 요청 하나가 끝까지 동작하는지, 그리고 개발할 때 쓰던 H2가 아닌 실제 데이터베이스에서도 같은 SQL이 도는지입니다. 이 Chapter는 그 두 가지를 검사합니다.
이 Chapter에서 만드는 것
| 만드는 것 | 설명 |
|---|---|
| 시나리오 테스트 | 진짜 서버를 임의 포트에 띄우고 RestClient로 등록·중복·검증·수정·삭제를 한 흐름으로 검사 |
@Sql 테스트 |
테스트마다 필요한 데이터를 SQL 파일로 준비하고 지움 |
| PostgreSQL 컨테이너 테스트 | Testcontainers로 실제 PostgreSQL 17에 연결해 같은 매퍼가 도는지 검사 |
로컬에서는 9건이 통과하고 컨테이너 테스트 3건은 건너뛰어졌으며(SKIPPED), GitHub Actions에서는 그 3건이 모두 통과(PASSED)했습니다.
직접 실행해 확인한 결과
| 확인 | 결과 |
|---|---|
ch29 test |
12건 중 9건 통과(컨텍스트 1, 시나리오 6, @Sql 2), 컨테이너 테스트 3건 SKIPPED |
| 로컬에서 Testcontainers 재시도 | Docker 소켓을 연결하자 컨테이너는 기동했지만 앱의 JDBC 접속이 Connect timed out으로 실패해 컨텍스트가 뜨지 못함. 재검증에서도 로컬 재현은 하지 못함 |
Testcontainers 연결까지 포함해 PostgreSQL 컨테이너 테스트가 PASSED라는 근거는 원고 작성 시 기록한 GitHub Actions 로그뿐입니다. 매퍼가 PostgreSQL에서 도는지는 별도의 우회 실행으로도 확인했습니다(아래 “로컬에서 컨테이너 테스트를 돌리지 못한 사정” 절).
사전 지식
- Chapter 19의 슬라이스 테스트, 앞 Chapter의 사용자 CRUD.
- Docker 사용 경험이 있으면 좋지만 필수는 아닙니다(컨테이너 테스트는 Docker가 없으면 건너뜁니다).
- 코드는
examples/ch29-integration입니다.
확인 환경
Docker 컨테이너(JDK 21.0.11), Spring Boot 4.1.1, Testcontainers 2.0.5, PostgreSQL postgres:17-alpine(드라이버 42.7.13)입니다. 컨테이너 테스트는 로컬 샌드박스에서 직접 돌리지 못해 GitHub Actions 로그와 우회 확인으로 갈음했습니다(아래 “로컬에서 컨테이너 테스트를 돌리지 못한 사정” 절). Windows는 확인하지 못했습니다.
예제 코드
| 대상 | 링크 |
|---|---|
| Chapter 전체 | ch29-integration/ |
| 시나리오 테스트 | UserScenarioIntegrationTests.java |
| SQL 준비 테스트 | UserSqlDataIntegrationTests.java |
| 컨테이너 테스트 | PostgresContainerIntegrationTests.java |
진짜 서버에 진짜 HTTP로
@SpringBootTest(webEnvironment = RANDOM_PORT)는 임의의 포트에 서버를 띄웁니다. RestClient로 호출하면 컨트롤러, 검증, 서비스, MyBatis, H2가 모두 실제로 이어진 채로 동작합니다. MockMvc가 서버 없이 DispatcherServlet만 거치는 것과 달리, 이쪽은 실제 Tomcat과 HTTP를 지납니다.
테스트 틀
@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
@TestMethodOrder(MethodOrderer.OrderAnnotation.class)
class UserScenarioIntegrationTests {
@LocalServerPort int port;
...
}
RANDOM_PORT: 8080 같은 고정 포트를 쓰지 않으므로 포트 충돌이 없습니다.@LocalServerPort: 실제로 뜬 포트 번호를 주입받습니다. 이 값으로RestClient의 기준 주소를 만듭니다.
여섯 단계 시나리오
| 단계 | 검사 |
|---|---|
| 1 | 처음 데이터 확인 |
| 2 | 등록 → 201과 Location, DB가 채운 createdAt |
| 3 | 같은 이메일 등록 → 409 |
| 4 | 잘못된 값 등록 → 400 |
| 5 | 수정 |
| 6 | 삭제 후 조회 → 404 |
단계가 앞 단계에서 생긴 id에 기대기 때문에 실행 순서를 @Order로 고정했습니다. 단계를 서로 독립시킬 수 있다면 순서에 기대지 않는 편이 낫습니다. 이 방식은 하나의 흐름 자체가 검사 대상일 때만 썼습니다.
4xx를 값으로 검사하기
기본 RestClient는 4xx/5xx 응답에서 예외를 던집니다. 상태 코드를 값으로 검사하려고 오류 핸들러를 비웠습니다.
RestClient.builder()
.baseUrl("http://localhost:" + port)
.defaultStatusHandler(HttpStatusCode::isError, (req, res) -> { })
.build();
이 코드는 개념을 보이기 위한 모양이며, 실제 생성 코드는 저장소의 테스트를 참고하세요. 핸들러를 비우면 409, 400, 404도 예외 없이 응답 객체로 돌아와 statusCode를 assert할 수 있습니다.
MockMvc와 무엇이 다른가
| 항목 | MockMvc | RANDOM_PORT + RestClient |
|---|---|---|
| 서버 | 없음(DispatcherServlet만) | 실제 Tomcat |
| HTTP | 흉내 | 실제 네트워크(루프백) |
| 속도 | 더 빠른 편 | 더 느린 편 (이 예제에서 측정하지 않음) |
| 확인 범위 | 컨트롤러 이하 | 서버 설정, 직렬화까지 |
둘 중 하나가 낫다기보다, 확인하려는 범위에 맞춰 고릅니다.
따라 하기
./gradlew :examples:ch29-integration:test --tests '*UserScenarioIntegrationTests*'
여섯 단계(등록 201 → 중복 409 → 검증 400 → 수정 → 삭제 후 404)가 한 흐름으로 통과합니다. 재검증에서 6건이 통과했습니다.
자주 하는 실수
| 실수 | 증상 | 해결 |
|---|---|---|
RestClient 기본값으로 4xx 검사 |
HttpClientErrorException |
오류 핸들러를 비워 상태 코드를 값으로 검사 |
@Order 없이 흐름 테스트 |
앞 단계 id가 없어 실패 | 순서 고정 또는 독립 테스트 |
| 고정 포트(8080) 사용 | 포트 충돌 | RANDOM_PORT + @LocalServerPort |
확인 문제
- MockMvc와
RANDOM_PORT의 가장 큰 차이는 무엇인가요? - 단계가 서로 기대는 흐름 테스트의 약점은 무엇인가요?
답: 1) MockMvc는 서버 없이 DispatcherServlet만 쓰고, RANDOM_PORT는 실제 Tomcat에 실제 HTTP로 요청합니다. 2) 앞 단계가 실패하면 뒤 단계가 의미 없이 줄줄이 실패하고 순서에 의존하게 됩니다.
직접 해 보기
@Order를 지우고 실행해 어떤 단계부터 실패하는지 보세요.- 오류 핸들러를 빼고 3단계가 어떻게 되는지 보세요(아래 “통합 테스트에서 자주 만나는 오류” 절의 1번).
- 시나리오를 단계별로 독립된 테스트로 쪼갤 수 있을지 생각해 보세요.
테스트 데이터는 SQL 파일로 준비하고 지운다
테스트마다 필요한 행이 다를 때는 @Sql이 편합니다. 그러나 영속 슬라이스와 다른 점이 있습니다. 이 예제의 테스트에는 @Transactional이 없으므로 @Sql이 넣은 행은 커밋되고 롤백되지 않습니다. @Sql 자체가 항상 커밋하는 것은 아니고, 테스트에 트랜잭션이 있는지에 따라 달라집니다(아래 “왜 새는가”의 표).
코드
@Sql(scripts = "/sql/extra-users.sql")
@Sql(scripts = "/sql/cleanup-extra-users.sql", executionPhase = Sql.ExecutionPhase.AFTER_TEST_METHOD)
void preparedRowsAreVisibleThroughTheApi() { ... }
- 첫
@Sql은 테스트 전에 행을 넣습니다. - 둘째는
AFTER_TEST_METHOD라서 테스트 뒤에 정리 스크립트를 실행합니다. - 정리 뒤에 행이 없음을 확인하는 테스트(
preparedRowsAreGoneAfterTheCleanupScript)를 따로 두었습니다. extra-users.sql은 맨 위에서 같은 이메일을 먼저 지웁니다. 이전 실행의 찌꺼기가 있어도 중복 오류가 나지 않게 하는 방어입니다.
왜 새는가
@MybatisTest는 테스트 전체를 트랜잭션에 넣고 끝나면 롤백했습니다. 반면 이 예제의 @Sql은 테스트 트랜잭션 없이 실행되어 넣은 행이 커밋됩니다. 정리 스크립트가 없으면 다음 테스트가 그 행을 봅니다. 이 증상은 아래 “통합 테스트에서 자주 만나는 오류” 절의 2번에서 Expected size: 3 but was: 5로 실제로 만들어 봅니다.
| 방식 | @Sql 데이터가 사라지는 시점 |
|---|---|
| 테스트에 트랜잭션 없음(이 예제) + 정리 없음 | 사라지지 않음 |
| 테스트에 트랜잭션 없음 + 정리 스크립트 | AFTER_TEST_METHOD에 직접 지움 |
@Transactional 테스트 + 기본 INFERRED |
@Sql이 테스트 트랜잭션에 참여하므로 테스트가 끝나며 롤백 |
@SqlConfig(transactionMode = ISOLATED) |
별도 트랜잭션에서 커밋되므로 롤백되지 않음 |
예제 테스트가 아닌 별도 하네스에서 @Transactional + @Sql INSERT를 실행했더니 테스트 안에서 행이 1개 보였고 테스트가 끝난 뒤에는 0개였습니다. 이 관찰은 그 하네스 한 번의 실행 결과이며, 예제 저장소의 테스트로는 확인하지 않았습니다. 이 절의 예제(UserSqlDataIntegrationTests)는 @Transactional이 없는 경우라서 정리 스크립트가 필요합니다. 일반 규칙은 “트랜잭션 없이 실행된 @Sql은 커밋된다”입니다. 근거는 Spring 공식 문서입니다.
따라 하기
./gradlew :examples:ch29-integration:test --tests '*UserSqlDataIntegrationTests*'
재검증에서 2건(행이 보이는지, 정리 뒤 사라졌는지)이 통과했습니다. 스크립트는 src/test/resources/sql/extra-users.sql과 cleanup-extra-users.sql입니다.
자주 하는 실수
| 실수 | 증상 | 해결 |
|---|---|---|
| 정리 스크립트를 두지 않음 | 다음 테스트가 Expected size: 3 but was: 5 |
AFTER_TEST_METHOD 정리 |
| 준비 스크립트가 이전 찌꺼기를 고려하지 않음 | 중복 키 오류 | 시작 부분에서 먼저 삭제 |
테스트 트랜잭션이 없는데 @Sql 데이터가 롤백될 것이라 가정 |
데이터가 남음 | 트랜잭션 없는 @Sql은 커밋됨을 기억하고 정리 스크립트 작성 |
확인 문제
@MybatisTest는 데이터가 사라지는데 이 예제의@Sql은 왜 남나요?- 정리가 제대로 됐는지 어떻게 확인하나요?
답: 1) 영속 슬라이스는 테스트 전체를 트랜잭션으로 감싸 롤백하지만, 이 예제의 테스트는 트랜잭션 없이 @Sql을 실행하므로 행이 커밋되기 때문입니다. 테스트에 @Transactional을 붙이면 기본 INFERRED 모드에서 @Sql도 롤백됩니다. 2) 정리 뒤 행이 없음을 확인하는 테스트를 따로 둡니다.
직접 해 보기
- 정리
@Sql을 지우고 다른 테스트가 어떻게 실패하는지 확인하세요. @Sql을 쓰는 테스트에@Transactional을 붙이면 롤백이 되는지 실험해 보세요(예제 저장소의 테스트로는 확인하지 않았고, 별도 하네스에서 한 번 관찰한 결과만 “왜 새는가”에 적었습니다).- 정리 스크립트 대신
@Sql을BEFORE_TEST_METHOD에서 먼저 지우고 넣는 방식의 장단점을 적어 보세요.
같은 SQL이 PostgreSQL에서도 도는가
개발과 테스트에는 가벼운 H2를 쓰고 운영에는 다른 DB를 쓰는 경우가 많습니다. H2에서 통과한 SQL이 실제 DB에서도 같은 결과를 낼까요? Testcontainers는 테스트가 시작될 때 실제 PostgreSQL 컨테이너를 띄워 이 질문에 답하게 해 줍니다. (Chapter 11에서 Oracle과 H2의 차이를 겪은 것과 같은 종류의 문제입니다.)
코드
@Testcontainers(disabledWithoutDocker = true)
@SpringBootTest(properties = "spring.sql.init.mode=always")
@Transactional
class PostgresContainerIntegrationTests {
@Container
@ServiceConnection
static PostgreSQLContainer postgres = new PostgreSQLContainer("postgres:17-alpine");
}
코드 읽기
@Container: 테스트 시작 때 컨테이너를 띄우고 끝나면 정리합니다.@ServiceConnection: 컨테이너의 접속 정보(URL, 사용자, 비밀번호)를 DataSource 설정에 자동으로 연결합니다. 테스트 코드에 접속 정보를 적지 않습니다.disabledWithoutDocker = true: Docker가 없으면 이 클래스를 건너뜁니다. 개발 PC에서는 건너뛰어도 빌드가 깨지지 않고, GitHub Actions의ubuntu-latest에서는 실제로 실행됩니다.@Transactional: 각 테스트가 롤백되어 서로 독립입니다.
확인한 것
GitHub Actions 로그에서 이 클래스의 세 테스트가 모두 PASSED였습니다.
| 테스트 | 확인 |
|---|---|
| 버전 확인 | select version()이 PostgreSQL 17로 시작 |
| 매퍼 | 앞 Chapter와 같은 매퍼가 그대로 동작 |
| UNIQUE 위반 | H2에서와 같은 DuplicateKeyException으로 올라옴 |
처음에는 실패했다
실제 DB에 처음 연결했을 때의 오류입니다.
ERROR: relation "users" does not exist
schema.sql과 data.sql이 실행되지 않았습니다. 이 스크립트는 임베디드 DB(H2)에서만 자동으로 실행되는 것이 기본값이라서, H2에서는 아무 설정 없이 돌던 것이 PostgreSQL에서는 돌지 않았습니다. 테스트에 spring.sql.init.mode=always를 주어 해결했습니다. H2만으로 테스트했다면 알 수 없었을 차이입니다.
확인 문제
@ServiceConnection이 하는 일은 무엇인가요?- 처음 PostgreSQL에 연결했을 때
relation "users" does not exist가 난 이유는 무엇인가요?
답: 1) 컨테이너의 접속 정보를 DataSource 설정에 자동으로 연결합니다. 2) schema.sql 자동 실행이 임베디드 DB(H2)에서만 기본이라 실제 DB에서는 spring.sql.init.mode=always가 필요하기 때문입니다.
직접 해 보기
spring.sql.init.mode=always를 지우고 오류를 재현해 보세요(Docker가 있는 환경).- 컨테이너 이미지 태그를 다른 버전으로 바꿔 보세요(이 예제는 17만 확인했습니다).
- 자신의 프로젝트에서 H2에서만 통과하고 운영 DB에서 실패할 만한 SQL을 찾아 보세요.
자주 하는 실수
| 실수 | 증상 | 해결 |
|---|---|---|
disabledWithoutDocker를 빼고 Docker 없는 환경에서 실행 |
Could not find a valid Docker environment |
옵션 사용 또는 Docker 준비 |
| 스크립트 초기화 설정 없이 실제 DB 사용 | 테이블 없음 | spring.sql.init.mode=always |
| H2에서 통과했으니 운영 DB도 같다고 가정 | 문법·제약 차이 | 실제 DB 컨테이너로 확인 |
로컬에서 컨테이너 테스트를 돌리지 못한 사정
이 과정의 개발 환경은 Gradle을 Docker 컨테이너 안에서 실행합니다. 그 안에서 Testcontainers를 쓰려다 막혔습니다. 막힌 과정과 그 대신 무엇으로 확인했는지를 정직하게 적습니다. 실제 개발 환경에서 비슷한 상황을 만났을 때 참고가 됩니다.
무엇이 막혔나
docker.sock을 마운트하고 host.docker.internal을 지정하는 방법을 시도했습니다. Docker는 인식했지만 Testcontainers가 띄우는 보조 컨테이너(Ryuk)의 포트에 접속하지 못해 중단했습니다. 컨테이너에서 호스트 게이트웨이의 게시된 포트로 접속하는 경로가 이 환경에서 막혀 있었습니다. --network host는 Gradle 연결이 깨져 쓰지 못했습니다. 이 환경에서 Testcontainers를 쓰는 방법은 찾지 못했습니다.
대신 확인한 두 가지
| 확인 | 내용 | 한계 |
|---|---|---|
| 우회 실행 | 테스트 본문에서 Testcontainers 부분만 뺀 임시 테스트를, 별도로 띄운 PostgreSQL 17 컨테이너에 환경 변수로 접속해 실행. 3건 통과(임시 테스트는 삭제) | Testcontainers 연결 자체는 검증되지 않음 |
| CI 실행 | GitHub Actions에서 PostgresContainerIntegrationTests 3건이 PASSED |
로그로 확인한 것이며, 로컬 재현은 못 함 |
즉 “매퍼가 PostgreSQL에서 도는가”는 우회 실행으로, “Testcontainers가 올바르게 붙는가”는 CI로 확인했습니다.
로컬 결과의 읽는 법
로컬 test 결과는 9건 통과, 3건 SKIPPED입니다. SKIPPED는 실패가 아니지만 통과도 아닙니다. disabledWithoutDocker는 편리하지만 조용히 통과하는 부작용이 있으므로, CI 로그에서 SKIPPED가 아니라 PASSED로 나왔는지 직접 세어야 합니다. 이 저장소의 CI는 build 잡에서 전체 422건이 통과하고 19건이 SKIPPED로 집계되었습니다(Docker 없는 환경의 건너뜀과 별개의 건도 섞여 있을 수 있어, 이 19건의 내역은 이 절에서 풀어 쓰지 않았습니다).
재검증에서 다시 시도한 결과
Docker 소켓(/var/run/docker.sock)을 빌드 컨테이너에 연결하고 TESTCONTAINERS_HOST_OVERRIDE를 Docker 브리지 게이트웨이 주소로 지정해 다시 실행했습니다.
| 단계 | 결과 |
|---|---|
| Docker 인식 | 성공(컨테이너가 기동됨) |
| 앱의 JDBC 접속 | 실패: PSQLException: The connection attempt failed ← SocketTimeoutException: Connect timed out |
| 테스트 | 컨텍스트 로드 실패로 FAILED (코드 문제가 아니라 환경의 네트워크 경로 문제) |
“Docker는 인식하지만 접속이 안 된다”는 위 “무엇이 막혔나”의 설명과 같은 모양입니다. 원인이 네트워크 경로(Docker 안의 Docker)라는 점만 확인했고, 해결 방법은 찾지 못했습니다.
자주 하는 실수
| 실수 | 증상 | 해결 |
|---|---|---|
SKIPPED를 통과로 보고함 |
실행되지 않은 경로를 검증된 것으로 오해 | PASSED 건수를 따로 셈 |
| 로컬에서 안 도는 테스트를 그냥 둠 | CI에서도 안 돌아도 모름 | CI에서 건너뜀 0건을 확인 |
| 우회 실행 결과를 Testcontainers 검증으로 착각 | 연결 방식 검증은 누락 | 우회 실행은 “매퍼가 PostgreSQL에서 도는가”만 보장 |
직접 해 보기
- 자신의 CI 로그에서
SKIPPED된 테스트 목록을 찾아 이유를 확인하세요. - Docker가 있는 PC에서 컨테이너 테스트가 도는지 실행해 보세요.
- CI에서 건너뜀이 0건이어야 하는 테스트를 정해 보세요.
통합 테스트에서 자주 만나는 오류
통합 테스트는 실제로 이어 붙이는 만큼 실패 모양도 다양합니다. 아래 메시지는 이 예제에서 같은 실수를 일부러 만들어 얻은 것입니다(길이를 줄이고 패키지 이름을 줄여 옮겼습니다). 오류를 일으킨 테스트는 확인 뒤 지웠습니다.
1. 409를 검사하려는데 예외가 터진다
RestClient를 기본값으로 만들고 중복 이메일을 보내면, 상태 코드를 검사하기도 전에 예외가 납니다.
org.springframework.web.client.HttpClientErrorException$Conflict: 409 Conflict: "{"message":"이미 사용 중인 이메일입니다","code":"DUPLICATE_EMAIL"}"
서버는 의도대로 409와 오류 JSON을 돌려줬습니다. 클라이언트가 4xx/5xx를 예외로 바꾼 것입니다. 상태 코드를 값으로 검사하려면 앞의 “진짜 서버에 진짜 HTTP로” 절에서 본 defaultStatusHandler로 오류 핸들러를 비웁니다. 메시지 뒤쪽에 서버의 응답 본문이 붙어 있으므로, 서버가 정말 기대한 오류를 냈는지는 그 본문으로 확인할 수 있습니다.
2. 앞 테스트의 데이터가 뒤 테스트로 샌다
@Sql로 행 두 개를 넣고 정리 스크립트를 두지 않은 경우입니다. 다음 테스트가 처음 3건을 기대했습니다.
java.lang.AssertionError:
Expected size: 3 but was: 5 in:
[...ch29.User@278c67a7, ... (5건)]
앞 테스트는 통과하고 뒤 테스트가 실패하므로 뒤 테스트가 틀린 것처럼 보입니다. 실제 원인은 테스트 트랜잭션 없이 실행된 @Sql이 커밋되어 남은 행입니다. 증상이 실행 순서에 따라 달라지고, 한 테스트만 따로 돌리면 통과하는 것이 단서입니다. 혼자 돌리면 통과하고 같이 돌리면 실패하는 테스트는 먼저 데이터 누수를 의심합니다. 정리 스크립트(AFTER_TEST_METHOD)를 붙이거나 롤백되는 @Transactional을 씁니다.
3. 테이블이 없다고 한다
org.springframework.jdbc.BadSqlGrammarException:
### Error querying database. Cause: org.h2.jdbc.JdbcSQLSyntaxErrorException: Table "USERS" not found (this database is empty); SQL statement:
SELECT id, name, email, age, created_at FROM users ORDER BY id [42104-240]
### The error may involve ...ch29.UserMapper.findAll
schema.sql이 실행되지 않았을 때의 모양입니다. 여기서는 spring.sql.init.mode=never로 일부러 막아 같은 증상을 만들었습니다. 실제 PostgreSQL에서 만난 relation "users" does not exist와 원인이 같습니다. this database is empty라는 H2의 안내가 단서입니다. 쿼리를 고치기 전에 스크립트 실행 설정(spring.sql.init.mode)부터 확인합니다. 이 재현은 PostgreSQL이 아니라 H2에서 만든 것입니다.
4. Docker를 찾을 수 없다
@Testcontainers에서 disabledWithoutDocker = true를 빼면 Docker가 없는 환경에서 건너뛰지 않고 실패합니다.
java.lang.IllegalStateException: Could not find a valid Docker environment. Please see logs and check configuration
Suppressed: org.testcontainers.containers.ContainerFetchException: Can't get Docker image: RemoteDockerImage(imageName=postgres:17-alpine, ...)
테스트 코드는 맞는데 실행 환경이 Docker에 닿지 못할 때 나옵니다. 확인할 것은 docker ps가 되는지, 현재 사용자가 Docker 소켓을 쓸 수 있는지, Gradle이 Docker 안에서 도는지입니다(앞의 “로컬에서 컨테이너 테스트를 돌리지 못한 사정” 절). 팀에 Docker 없는 PC가 섞여 있다면 건너뛰게 하고 CI에서 실행되게 하는 편이 현실적이지만, 건너뛰는 설정은 조용히 통과하는 부작용이 있습니다.
증상별 점검표
| 증상 | 가장 먼저 볼 것 |
|---|---|
HttpClientErrorException$Conflict 등 4xx 예외 |
RestClient의 오류 핸들러, 응답 본문 |
| 혼자 돌리면 통과, 같이 돌리면 실패 | @Sql 정리 스크립트, 커밋된 데이터 |
Table "USERS" not found / relation does not exist |
spring.sql.init.mode, 스키마 스크립트 |
Could not find a valid Docker environment |
Docker 실행 여부, 소켓 권한, Gradle이 도는 위치 |
직접 해 보기
- 2번 증상을 재현하고 테스트를 하나만 실행해 통과하는지 확인하세요.
- 3번에서
this database is empty가 뜻하는 바를 한 문장으로 적어 보세요. - 4번 오류를
docker ps확인 순서로 진단하는 체크리스트를 만들어 보세요.
한계와 다음 단계
이 Chapter를 마무리하며 확인한 것과 확인하지 못한 것을 정리합니다.
만든 것
- 실제 서버를 임의 포트에 띄운 여섯 단계 시나리오(RANDOM_PORT,
RestClient). @Sql로 준비하고 정리하는 테스트 데이터.- PostgreSQL 17 컨테이너 위에서 도는 매퍼 테스트 3건(CI에서
PASSED).
한계와 확인하지 않은 것
| 항목 | 상태 |
|---|---|
| 로컬에서 Testcontainers 직접 실행 | 못 함. 우회 실행과 CI 로그로 대체 |
| PostgreSQL 17 외 버전 | 확인하지 않음 |
| 컨테이너 재사용 설정, 병렬 실행 격리 | 다루지 않음 |
| 소비자 주도 계약 테스트 | 다루지 않음 |
| 컨테이너 테스트 실행 시간 | 측정하지 않음 |
| Oracle 컨테이너 | 이 Chapter에서 다루지 않음. 다른 Chapter에서 Oracle 연동을 다룬 것과 별개 |
@Sql과 @Transactional을 함께 쓸 때의 롤백 |
예제 테스트로는 확인하지 않음. 별도 하네스에서 한 번 실행해 테스트 안 1행, 종료 뒤 0행을 관찰함 |
슬라이스와 통합의 역할 분담
Chapter 19에서 “목으로 이어 붙인 이음새는 검증되지 않는다”고 했습니다. 이 Chapter의 시나리오 테스트가 그 이음새를 채웁니다. 반대로 통합 테스트는 실패했을 때 원인이 넓습니다. 그래서 먼저 슬라이스로 계층별 원인을 좁히고, 통합 테스트는 흐름 전체가 이어지는지만 소수로 둡니다.
테스트 종류별 CI 확인 항목
| 테스트 | CI에서 확인할 것 |
|---|---|
| 시나리오(H2) | PASSED 6건 |
@Sql |
PASSED 2건 |
| PostgreSQL 컨테이너 | PASSED 3건 (SKIPPED가 아니어야 함) |
직접 해 보기
- 자신의 프로젝트에서 통합 테스트로 꼭 지켜야 할 흐름 3개를 골라 보세요.
- 슬라이스 테스트로 충분한데 통합 테스트로 쓴 것이 있는지 점검하세요.
- 이 Chapter의 테스트를 CI에서 어떤 순서로 돌릴지 설계해 보세요.
용어와 참고 자료
Chapter 20의 용어를 모았습니다. 단위·슬라이스 테스트 용어는 Chapter 19 용어 정리를 참고하세요.
용어
| 용어 | 설명 | 나온 곳 |
|---|---|---|
| 통합 테스트 | 여러 계층을 실제로 이어 붙여 하나의 흐름으로 검사하는 테스트입니다. | 진짜 서버에 진짜 HTTP로 |
RANDOM_PORT |
테스트 서버를 임의의 빈 포트에 띄우는 설정입니다. | 진짜 서버에 진짜 HTTP로 |
@LocalServerPort |
실제로 뜬 서버의 포트를 주입받는 애노테이션입니다. | 진짜 서버에 진짜 HTTP로 |
RestClient |
스프링의 동기 HTTP 클라이언트입니다. | 진짜 서버에 진짜 HTTP로 |
@Sql |
테스트 전후에 SQL 파일을 실행하는 스프링 테스트 애노테이션입니다. | 테스트 데이터는 SQL 파일로 준비하고 지운다 |
| Testcontainers | 테스트 중에 Docker 컨테이너를 띄우고 정리해 주는 라이브러리입니다. | 같은 SQL이 PostgreSQL에서도 도는가 |
@ServiceConnection |
컨테이너의 접속 정보를 스프링 설정에 자동으로 연결하는 애노테이션입니다. | 같은 SQL이 PostgreSQL에서도 도는가 |
| 임베디드 DB | 애플리케이션과 같은 프로세스에서 도는 인메모리 DB입니다(H2 등). | 같은 SQL이 PostgreSQL에서도 도는가 |
spring.sql.init.mode |
schema.sql/data.sql 자동 실행 여부를 정하는 설정입니다. |
같은 SQL이 PostgreSQL에서도 도는가 |
| SKIPPED | 조건이 맞지 않아 건너뛴 테스트 결과입니다. 통과가 아닙니다. | 로컬에서 컨테이너 테스트를 돌리지 못한 사정 |
참고 자료
- Spring Boot - Testcontainers:
@ServiceConnection과 컨테이너 연동 방식을 확인했습니다. - Testcontainers for Java - PostgreSQL Module:
PostgreSQLContainer의 사용법을 확인했습니다.
직접 해보기
./gradlew :examples:ch29-integration:test --tests '*UserScenarioIntegrationTests*'로 여섯 단계 시나리오를 실행해 보세요. 이어서@Order를 지웠을 때와defaultStatusHandler를 뺐을 때 각각 어느 단계부터 어떻게 실패하는지 확인하고 되돌립니다../gradlew :examples:ch29-integration:test --tests '*UserSqlDataIntegrationTests*'를 실행한 뒤cleanup-extra-users.sql을 실행하는@Sql을 지우고, 다른 테스트가 어떻게 실패하는지 본문의Expected size: 3 but was: 5와 비교해 보세요. 실패한 테스트를 혼자 돌리면 통과하는지도 확인합니다.- Docker가 있는 환경에서
PostgresContainerIntegrationTests를 실행하고 결과가SKIPPED가 아니라PASSED인지 세어 보세요.spring.sql.init.mode=always를 지우고relation "users" does not exist가 재현되는지도 확인합니다. disabledWithoutDocker = true를 빼고 Docker가 없는 환경에서 실행해Could not find a valid Docker environment를 읽어 보세요.docker ps, Docker 소켓 권한, Gradle이 도는 위치 순서로 점검표를 만들어 봅니다.- 자신의 CI 로그에서
SKIPPED된 테스트를 찾아 이유를 적고, 이 Chapter처럼 시나리오 6건,@Sql2건, PostgreSQL 컨테이너 3건을PASSED로 세는 확인 항목을 정해 보세요.
이번 장의 정리
- 슬라이스 테스트가 모두 통과해도, 계층이 실제로 이어진 흐름과 실제 데이터베이스에서 도는 SQL은 따로 검사해야 합니다.
@SpringBootTest(webEnvironment = RANDOM_PORT)와@LocalServerPort로 실제 Tomcat을 임의 포트에 띄우고,RestClient의defaultStatusHandler로 오류 핸들러를 비워 409, 400, 404를 값으로 검사합니다.- 여섯 단계 시나리오는 앞 단계에서 생긴 id에 기대므로
@Order로 순서를 고정했고, 이 방식은 흐름 자체가 검사 대상일 때만 썼습니다. - 테스트 트랜잭션 없이 실행된
@Sql데이터는 커밋되므로AFTER_TEST_METHOD정리 스크립트로 지우고, 정리 뒤 행이 없음을 확인하는 테스트를 따로 둡니다. - Testcontainers와
@ServiceConnection으로 PostgreSQL 17에 연결했습니다.schema.sql은 임베디드 DB에서만 자동 실행되는 것이 기본값이라spring.sql.init.mode=always가 필요했습니다. - 로컬에서는 컨테이너 테스트 3건이
SKIPPED였고,PASSED근거는 GitHub Actions 로그와 우회 실행뿐입니다.SKIPPED는 통과가 아니므로 CI에서PASSED건수를 따로 셉니다. - 통합 테스트 오류는 4xx 예외, 데이터 누수, 테이블 없음, Docker 없음으로 나누고, 각각 오류 핸들러, 정리 스크립트,
spring.sql.init.mode, Docker 실행 환경부터 확인합니다.
다음 Chapter 21 Spring Security에서는 인증(401)과 인가(403)를 나누고, 역할과 데이터에 따른 규칙을 걸어 막혀야 하는 요청까지 테스트합니다.