RestAssured kotlin extension 트러블슈팅

주노·2024년 7월 30일

@RestAssured Hibernate JPA Springboot

기술부채 알쓸신잡

목록 보기

18/21

서론

테스트코드를 작성할 생각에 싱글벙글하고있었는데 계속해서 에러가 터지는 바람에 머리를 쥐어싸고 장장 2시간동안 서칭하며 화를... 꾹 삭히다가 문제점을 발견하고 기록을 남겨본다.

(정리하다보니 행복해짐)

어쩌다가..

Kotlin + SpringBoot 프로젝트로 테스트를 작성하는 과정에서 실제 API를 호출하는 테스트를 쓰고싶었다.

기존에 Java에서 써왔던 RestAssured를 사용해볼까나? 하다가 코틀린 Extension 모듈이 있길래 한번 사용해봤다.

해당 Extention을 넣고 싱글벙글 테스트코드를 대충 써보고 한번 실행해봤다.

@ActiveProfiles("test", "no-fcm")
@SpringBootTest(webEnvironment = WebEnvironment.RANDOM_PORT)
class UserAcceptanceTest(
    @LocalServerPort
    private val port: Int,
) : StringSpec({
    extension(SpringExtension)
    val client = WebTestClient.bindToServer()
        .baseUrl("http://localhost:${port}")
        .build()

    val deviceId = "a1234567890"
    val accessToken = getAccessToken(client, deviceId)

    "/api/v1/users/me 요청을 수행한다" {
        "정상적으로 내 정보를 조회한다" {
            Given {
                webTestClient(client)
                header("Authorization", "Bearer $accessToken")
            } When {
                put("/api/v1/users/me")
            } Then {
                statusCode(200)
            }
        }
    }
})

그런데 이런 에러가 펑펑..!!

뭔가 이상해서 그냥 아무것도없는 ContextLoad 테스트도 돌려봤는데 동일한 오류가 발생했다.

@SpringBootTest
@ActiveProfiles("test")
class PomoNyangApplicationTests {
    @Test
    fun contextLoads() {
    }
}

이건 필히 라이브러리에 뭔가 문제가 있다는것을 의미했다.

근데 라이브러리 호환안되니까 사용안해! 하고 넘어갈수도 있을법한 일이였는데.. 오늘따라 삽질이 땡겼나? 라이브러리 안쓸 생각은 안하고 왜 안되는지 찾아보기 시작했었다.

jakarta 안녕?

에러 메시지를 눌러보다가 클래스명을 누르니 참조하는 클래스로 향하는것을 볼 수 있었다.

음..? 이 클래스 값을 왜 못찾지? 하고 choose Target File을 눌러보니 두개의 의존성을 가진다는것을 알았다.

하나는 RestAssured extension의 jakarta.jakartaee-web-api였고

다른 하나는 spring-boot-starter-data-jpa의 jakarta.persistence였다.

두 enum의 내용을 살펴보니 내용이 달랐다..!!

Hibernate 6.2 버전부터 UUID GenerationType이 추가 되었다고 한다.
출처: https://www.baeldung.com/java-hibernate-uuid-primary-key

근데 하나는 jakarta.jakartaee-web-api에서 불러온거고 다른 하나는 jakarta.persistence에서 불러온거다. 타고들어간 클래스, 패키지가 같은게 좀 이상했다.

두개의 차이가 뭘까? 궁금해져서 jakarta 스펙을 살펴봤다.

https://jakarta.ee/specifications/

jakarta.jakartaee-web-api는 Web에 도구들이 정의되어있다고한다.

Jakarta EE Web Profile API v9.1.0 Java Docs

jakarta.persistence는 좀더 세부적인 분류로 영속성에만 필요한 도구들을 둔 모듈이라고 볼 수 있다.

Jakarta Persistence Module v3.1 Java Docs

두 명세를 보면 Jakarta EE의 몇 버전으로부터 Release 되었는지 볼 수 있다.
Jakarta EE 10 버전부터 내가 원하는 Generation.UUID 값이 들어가있으니 jakarta.jakartaee-web-api 버전도 거기에 맞게 10 버전으로 올려주면 되겠다는 생각이 든다.