❗ [버그][AI] PlaceExtractionResponse 역직렬화 실패 - AI 서버 응답의 "message" 필드 미처리`

[Cassiiopeia]

🐛 버그 설명

POST /api/content/analyze 호출 시, 백엔드가 AI 서버로부터 정상 응답(200 OK)을 받았음에도 EXTERNAL_API_ERROR(502)를 반환합니다.

AI 서버 응답에 포함된 message 필드를 PlaceExtractionResponse DTO가 인식하지 못해 Jackson 역직렬화 예외가 발생합니다.

📍 에러 로그

AI server raw response: httpStatus=200, responseBody={"received":true,"message":"Processing started"}

com.fasterxml.jackson.databind.exc.UnrecognizedPropertyException: 
Unrecognized field "message" (class kr.suhsaechan.mapsy.ai.dto.PlaceExtractionResponse), 
not marked as ignorable (3 known properties: "received", "status", "contentId"])
  at kr.suhsaechan.mapsy.ai.service.AiServerService.sendPlaceExtractionRequest(AiServerService.java:81)

🔍 원인 분석

AI 서버 실제 응답:

{"received": true, "message": "Processing started"}

백엔드 DTO (PlaceExtractionResponse.java):

public class PlaceExtractionResponse {
    private UUID contentId;    // ✅
    private Boolean received;  // ✅
    private String status;     // ✅
    // ❌ message 필드 없음
}

Jackson이 strict mode로 동작하여, 알 수 없는 필드(message)가 있으면 예외를 던집니다.

✅ 제안하는 수정 방법

방법 A (권장): 알 수 없는 필드 무시

@JsonIgnoreProperties(ignoreUnknown = true)  // 추가
@Getter
@Builder
@NoArgsConstructor
@AllArgsConstructor
public class PlaceExtractionResponse {
    private UUID contentId;
    private Boolean received;
    private String status;
}

방법 B: message 필드 추가

@Getter
@Builder
@NoArgsConstructor
@AllArgsConstructor
public class PlaceExtractionResponse {
    private UUID contentId;
    private Boolean received;
    private String status;
    private String message;  // 추가
}

방법 A를 권장합니다. AI 서버 응답 형식이 변경되더라도 백엔드가 깨지지 않아 방어적입니다.

📁 수정 대상 파일

• MS-AI/src/main/java/kr/suhsaechan/mapsy/ai/dto/PlaceExtractionResponse.java

🔗 재현 방법

1. Flutter 앱에서 SNS URL 입력 후 분석 요청
2. 백엔드 → AI 서버 호출 성공 (200 OK)
3. 응답 역직렬화 시 UnrecognizedPropertyException 발생
4. EXTERNAL_API_ERROR (502)로 클라이언트에 반환

[Cassiiopeia]

Guide by SUH-LAB

브랜치

20260223_#36_PlaceExtractionResponse_역직렬화_실패_AI_서버_응답의_message_필드_미처리

커밋 메시지

PlaceExtractionResponse 역직렬화 실패 - AI 서버 응답의 "message" 필드 미처리` : feat : {변경 사항에 대한 설명} https://github.com/MapSee-Lab/MapSy-BE/issues/36

[Cassiiopeia]

📌 작업 개요

POST /api/content/analyze 호출 시, AI 서버로부터 정상 응답(200 OK)을 받았음에도 PlaceExtractionResponse DTO가 message 필드를 인식하지 못해 Jackson UnrecognizedPropertyException이 발생하고, 클라이언트에 EXTERNAL_API_ERROR(502)를 반환하는 버그 수정

🔍 문제 분석

AI 서버 실제 응답:

{"received": true, "message": "Processing started"}

기존 DTO 필드:

• contentId (UUID)
• received (Boolean)
• status (String)

message 필드가 DTO에 정의되어 있지 않아 Jackson이 strict mode로 역직렬화 시 예외 발생.
정상적인 200 OK 응답임에도 catch 블록에서 EXTERNAL_API_ERROR로 래핑되어 502 반환.

에러 발생 위치:
AiServerService.sendPlaceExtractionRequest() 메서드의 objectMapper.readValue() 호출 시점

✅ 구현 내용

1. PlaceExtractionResponse DTO 방어적 역직렬화 처리

• 파일: MS-AI/src/main/java/kr/suhsaechan/mapsy/ai/dto/PlaceExtractionResponse.java
• 변경 내용:
  • @JsonIgnoreProperties(ignoreUnknown = true) 어노테이션 추가 — AI 서버 응답에 알 수 없는 필드가 포함되어도 역직렬화 실패하지 않도록 방어적 처리
  • message 필드 추가 — AI 서버가 실제로 전송하는 "message": "Processing started" 값을 명시적으로 매핑

2. AiServerService 로그 개선

• 파일: MS-AI/src/main/java/kr/suhsaechan/mapsy/ai/service/AiServerService.java
• 변경 내용: AI 서버 응답 성공 로그에 message 필드 출력 추가
• 이유: 디버깅 시 AI 서버의 응답 메시지를 즉시 확인 가능하도록 개선

🔧 주요 변경사항 상세

PlaceExtractionResponse.java

이슈에서 제안한 방법 A(ignoreUnknown) + 방법 B(message 필드 추가)를 조합하여 적용.
@JsonIgnoreProperties(ignoreUnknown = true)로 향후 AI 서버 응답 형식이 변경되어도 백엔드가 깨지지 않도록 방어적 처리하면서, 현재 AI 서버가 보내는 message 필드도 명시적으로 매핑하여 활용 가능하도록 구현.

AiServerService.java

기존 로그 포맷 "contentId={}, received={}, status={}" → "contentId={}, received={}, status={}, message={}" 로 변경하여 AI 서버 응답 메시지를 로그에서 바로 확인 가능.

🧪 테스트 및 검증

• AI 서버 응답 {"received": true, "message": "Processing started"} → 정상 역직렬화 확인 필요
• AI 서버 응답에 예상치 못한 새 필드가 추가되어도 역직렬화 실패하지 않는지 확인 필요
• 기존 응답 형식 {"received": true, "contentId": "..."} 도 하위 호환 유지 확인 필요

📌 참고사항

• @JsonIgnoreProperties(ignoreUnknown = true) 적용으로 AI 서버 응답 스키마 변경에 대한 방어력 확보
• AI 서버와의 응답 스키마 동기화가 필요한 경우, message 필드의 값 규격을 AI 서버 팀과 협의 권장

[Cassiiopeia]

긴급건 Stable 반영 완료