Spring Boot Controller 반환 타입 최적화를 통한 API 설계 유연성 확보

Context

Spring Boot REST API 개발 시 일관되지 않은 Controller 반환 타입 사용으로 인한 유지보수 효율 저하 발생. HTTP 상태 코드 제어와 응답 바디 구성 간의 트레이드오프를 해결하기 위한 체계적인 반환 전략 필요.

Technical Solution

• 단순 CRUD 구현을 위한 Object/DTO 직접 반환 방식 채택으로 보일러플레이트 코드 제거 및 개발 속도 향상
• HTTP Status Code 및 Header의 정밀 제어를 위해 ResponseEntity를 활용한 전문적 API 응답 구조 설계
• DELETE 및 PATCH 작업 시 Response Body를 제외한 void 반환과 @ResponseStatus 설정을 통한 네트워크 페이로드 최적화
• I/O 바운드 작업의 Thread Blocking 문제 해결을 위해 CompletableFuture 기반의 Asynchronous 처리 도입
• 고동시성 환경 대응을 위한 WebFlux 기반 Mono/Flux 도입으로 Non-blocking 이벤트 루프 아키텍처 구현
• 내부 도메인 모델 노출 방지를 위해 Entity 대신 DTO를 반환하는 계층 간 분리 설계 적용