🔥❗[긴급][버그][AI장소추출][API] AI 장소 추출 요청 시 Validation 실패 - 필드명 불일치 (sourceUrl → snsUrl)

[Cassiiopeia]

🗒️ 설명

• AI 장소 추출 기능에서 SNS URL을 입력하고 "장소 추출하기" 버튼을 누르면 즉시 "URL 분석에 실패했습니다. 다시 시도해주세요." 오류 화면이 표시됨
• 백엔드 로그 확인 결과, POST /api/content/analyze 요청 시 Validation 실패: "snsUrl은 필수입니다." 에러가 반복 발생
• 원인: 프론트엔드(Flutter)에서 요청 body에 sourceUrl 필드명으로 전송하고 있으나, 백엔드 API(RequestPlaceExtractionRequest)는 snsUrl 필드명을 요구함
  • FE 전송: { "sourceUrl": "https://www.instagram.com/..." }
  • BE 기대: { "snsUrl": "https://www.instagram.com/..." }

🔄 재현 방법

1. 앱에서 AI 장소 추출 화면 진입
2. Instagram 또는 YouTube 링크를 입력
3. "장소 추출하기" 버튼 탭
4. 즉시 오류 화면 표시 ("URL 분석에 실패했습니다. 다시 시도해주세요.")

📸 참고 자료

백엔드 에러 로그:

2026-02-23T15:36:45.715+09:00 ERROR [mapsy] GlobalExceptionHandler: [예외 처리] Validation 실패: message=snsUrl은 필수입니다., path=/api/content/analyze, method=POST
2026-02-23T15:36:49.374+09:00 ERROR [mapsy] GlobalExceptionHandler: [예외 처리] Validation 실패: message=snsUrl은 필수입니다., path=/api/content/analyze, method=POST
2026-02-23T16:13:02.581+09:00 ERROR [mapsy] GlobalExceptionHandler: [예외 처리] Validation 실패: message=snsUrl은 필수입니다., path=/api/content/analyze, method=POST

백엔드 API 스펙 (api-docs):

• 엔드포인트: POST /api/content/analyze
• 요청 스키마: RequestPlaceExtractionRequest → 필수 필드: snsUrl (string)

프론트엔드 현재 코드:

• AnalyzeRequest 모델: sourceUrl 필드 사용 → toJson() 시 { "sourceUrl": "..." } 으로 직렬화

✅ 예상 동작

• SNS URL 입력 후 "장소 추출하기" 버튼을 누르면 정상적으로 AI 분석이 시작되어야 함
• 프론트엔드 요청 body의 필드명이 백엔드 API 스펙(snsUrl)과 일치해야 함

⚙️ 환경 정보

• OS: iOS (실기기 테스트)
• 앱 버전: 최신 빌드
• 백엔드: https://api.mapsy.suhsaechan.kr

🙋‍♂️ 담당자

• 백엔드: 이름
• 프론트엔드: @Cassiiopeia
• 디자인: 이름

[Cassiiopeia]

Guide by SUH-LAB

브랜치

20260223_#46_AI_장소_추출_요청_시_Validation_실패_필드명_불일치_sourceUrl_snsUrl

커밋 메시지

AI 장소 추출 요청 시 Validation 실패 - 필드명 불일치 (sourceUrl → snsUrl) : feat : {변경 사항에 대한 설명} https://github.com/MapSee-Lab/MapSy-FE/issues/46