Jackson 매핑 오류: JSON 필드와 Java 필드 불일치 문제 해결하기 (feat. 모델 api 연결)

Recipe-Recommender Model

💡Goal : 사용자가 가입 시 등록한 알레르기 정보와 선호도를 기반으로 '오늘의 추천 레시피'를 제공

JSON 요청: user_id

JSON 응답: recipe_id

 

문제

데이터/ai 팀에서 전달받은 input, output 값을 바탕으로 모델 api에 user_id를 넘기고, recipe_id를 받아오는 코드를 작성하였다.

근데 Postman으로 GET localhost:8080/api/recipes/recommend 요청을 보냈더니 json 필드가 일치하지 않는다는 에러가 발생했다.

 

RestTemplate은 기본적으로 Jackson을 사용해Map<String, Object>를 JSON으로 변환하기 때문에 {"user_id": "146"} 같은 JSON 형태로 모델 API에 전송된다.

응답 데이터 또한 Map<String, Object> 형태로 받기 때문에 모델 API가 JSON 응답을 반환하면, response.getBody()가 이를 {"recipe_id": 112}와 같은 JSON 형식으로 전달된다.

 

데이터/ai 팀은 데이터베이스 필드명을 바탕으로 설계를 했기 때문에 Java 객체와 필드명이 다르다는걸 염두에 두고 값을 전달할 때와 받을 때 모두 잘 매핑을 해놨는데도 자꾸 매핑되지 않는다는 에러가 떠서 로그를 찍어보았다.

Map<String, Object> requestPayload = Map.of("user_id", userId);

try {
    ResponseEntity<Map<String, Object>> response = restTemplate.exchange(
            recipeRecommendApiUrl,
            HttpMethod.POST,
            new HttpEntity<>(requestPayload),
            new ParameterizedTypeReference<>() {
            }
    );

    log.info("Calling AI model with userId: {}", userId);

    Map<String, Object> responseBody = response.getBody();
    if (!responseBody.containsKey("recipe_id")) {
        log.error("AI 모델 응답에 recipeId가 없습니다.");
        return new RecipeRecommendResponseDTO(null, null, null);
    }

    .
    .
    .
    
    // 추천 레시피 반환
    return new RecipeRecommendResponseDTO(
                                recipe.getId(),
                                recipe.getImagePath(),
                                recipe.getRecipeName());

    } catch (HttpClientErrorException e){
        log.error("AI 모델 API 호출 실패: {}", e.getStatusCode());
        return new RecipeRecommendResponseDTO(null, null, null);
    }

 

일단 로그를 통해 userId는 모델에 잘 전달되고 있는 것을 확인했다. 

Calling AI model with userId: 146

 

recipe_id가 널값이었다면 출력되어야 할 "AI 모델 응답에 recipeId가 없습니다."는 출력되지 않은걸 보아 recipe_id 값은 있지만 제대로 매핑이 되지않았음을 알 수 있었다. 다음으로 의심해본건 그 아래에 위치한 최종 응답값인 RecipeRecommendResponseDTO였다.

 

값을 담아 반환하는 RecipeRecommendResponseDTO에서는 여전히 필드명을 recipeId로 사용하고 있어서 발생한 문제였다..!

이 때문에 JSON 필드명(recipe_id)과 DTO 필드명(recipeId)이 일치하지 않아서 Jackson이 자동으로 매핑하지 못한 것이다.

 

해결 방법

@JsonProperty를 사용해서 JSON 필드명을 Java 필드에 명시적으로 매핑해주면 된다.

 

짜잔 이젠 오늘의 추천 레시피가 잘 나오는 것을 확인할 수 있다 :)