🚨 문제 상황

<aside>

파일 업로드 기능에서 두 가지 방식이 혼용되고 있었습니다.

• entityType을 통해 업로드 즉시 DB에 저장하는 방식
• 업로드 후 반환된 URL을 요청값에 직접 넣는 방식

이후 파일과 JSON 데이터를 한 번에 처리하기 위해 multipart 방식도 고려했으나 multipart와 JSON 데이터를 함께 받는 구조가 복잡하고 유지보수성이 떨어진다고 판단했습니다.

</aside>

🔍 문제 원인

<aside>

• 파일 처리 방식이 일관되지 않아 API마다 다른 처리 로직이 필요해 코드 복잡도 증가
• multipart + JSON 혼용 구조는 클라이언트 · 서버 양쪽 모두 처리 로직이 복잡해짐 </aside>

해결 과정

• 파일 업로드 시 S3에 저장 후 uuid 반환, 이후 API 요청 시 uuid 함께 전달하는 방식으로 통일

Before | 파일 업로드 → URL 반환 → URL을 요청값에 직접 삽입
After  | 파일 → BFF → Core → **S3 업로드** → DB 저장(**UUID 반환**)
       | UUID → BFF → Core → DB 조회 → S3 URL 반환

• 주요 필드 변경

PATCH /users/me       | profile_url → profile_image_uuid 변경
POST /rooms           | thumbnail_uuid 필드 추가
POST /medias/upload   | **entityType 쿼리 파라미터 제거**

• 응답값은 기존과 동일하게 S3 URL 반환 유지

💡 배운 점 및 느낀 점

<aside>

단순히 동작하는 구조가 아니라 유지보수성과 일관성을 고려한 API 설계가 중요함을 경험

파일 처리 방식을 통일함으로써 클라이언트 · 서버 간 불필요한 복잡도를 줄일 수 있음을 체감

</aside>

참고 자료