React Query와 함께하는 API 에러 처리 설계하기

본 글은 React Query를 사용하여 API 에러 처리의 체계를 잡는 방법에 대해 다룹니다. 레거시 프로젝트에서 발생하는 중복되고 일관성 없는 에러 처리 로직의 문제점을 지적하며, 이를 개선하기 위한 목표를 제시합니다.

모든 에러에 공통적으로 적용되는 규칙과 처리를 전역적으로 관리하여 개발자가 에러 처리에 대한 고민을 줄이고, 컴포넌트에서는 필요한 에러 처리 로직에 집중할 수 있도록 하는 것을 목표로 합니다. 이를 통해 프로젝트 전반의 유지보수성을 높이고 개발자 간의 일관된 에러 처리 방식을 확립하고자 합니다.

React Query의 onE 콜백을 활용한 에러 처리 흐름 설계에 초점을 맞추며, 에러 로그 발송이나 Alert 컴포넌트 설계 등은 제외합니다.