Spring Boot 기반 서비스에서 OAuth2 인증을 적용하다 보면, 어떤 API는 잘 동작하는데 특정 API에서만 401 Unauthorized 오류가 발생하는 경우가 있습니다. 이번 글에서는 실제 문제 해결 과정을 바탕으로, 원인 파악과 수정 방법을 정리해 보겠습니다.문제 상황여러 개의 API 서비스를 운영하며 공통 인증을 적용했습니다.일부 API는 정상 응답하지만, 특정 API 호출 시 401 Unauthorized 오류가 발생했습니다.서버 로그에는 별다른 오류가 없어 원인 추적이 쉽지 않았습니다.원인 후보처음에는 다양한 가능성을 의심했습니다.보안 필터 체인 매칭 문제: 특정 경로가 올바른 SecurityFilterChain을 타지 않는 경우게이트웨이/프록시 문제: Authorization 헤더..

Spring Boot 프로젝트를 진행하면서 그동안은 MyBatis로만 데이터베이스를 다뤄왔습니다. 하지만 이번 프로젝트에서는 JPA를 사용하게 되었고, 처음에는 다소 생소한 개념들이 많았지만 구조를 하나하나 정리하면서 점차 이해할 수 있었습니다. 이 글에서는 MyBatis만 사용해본 입장에서 JPA의 전체 구조를 어떻게 이해했는지 순서대로 정리해보겠습니다.JPA와 MyBatis의 가장 큰 차이점MyBatis는 SQL 중심의 프레임워크입니다. XML이나 어노테이션을 통해 SQL을 직접 작성하고, 그 결과를 Java 객체에 매핑합니다. 반면, JPA는 객체 중심으로 동작합니다. SQL은 자동으로 생성되며, 객체와 객체 사이의 관계를 바탕으로 데이터베이스와 소통합니다.즉, MyBatis는 "어떤 쿼리를 실행할..

문제 상황내부에서 운영 중인 두 개의 API Pod A와 B가 있습니다. Pod A는 Pod B의 특정 API를 호출하여 인증 등의 기능을 위임하고 있으며, 이들은 Kubernetes 클러스터 내에서 서비스 이름을 기반으로 통신하고 있습니다.문제는 간헐적으로 다음과 같은 예외가 발생한다는 점이었습니다.java.net.SocketException: Connection reset특정 시점에서 API 호출이 실패하고, 호출하는 쪽에서 위와 같은 오류가 발생했습니다. Pod B를 재시작하면 문제가 일시적으로 해결되었지만, 원인을 명확히 파악하지 못해 대응이 어려운 상황이었습니다.원인 분석에러 메시지와 인프라 구조를 바탕으로 다음과 같은 가능성을 검토하였습니다.1. 애플리케이션이 응답하지 않는 상태Pod 내부에서..

1. 에러 개요다음과 같은 에러 메시지가 로그에 출력되었습니다.org.springframework.web.client.ResourceAccessException: I/O error on POST request for [내부 서버 주소]: Connection reset이는 시스템 A에서 내부 시스템 B의 인증 API를 호출하려 했지만, 상대방 서버 측에서 연결을 강제로 종료시켜 발생한 네트워크 오류입니다.2. 에러의 의미Connection reset은 클라이언트가 요청을 보냈지만, 상대 서버가 응답을 주지 않고 연결을 끊어버린 상황을 의미합니다.보통 이는 응답 처리 중 문제가 발생했거나, 서버가 아예 요청을 수신하지 못한 경우에도 발생할 수 있습니다.3. 발생 가능한 원인다음과 같은 원인들이 있을 수 있습..

Spring 기반의 백엔드 개발을 하다 보면 다음과 같은 요구사항이 생길 수 있습니다.클라이언트에게는 일정한 응답 포맷을 유지하면서내부적으로는 경고 상황임을 감지해야 하며로그에는 ERROR 레벨이 아닌 WARN 또는 INFO 수준으로만 기록하고 싶다이 글에서는 위와 같은 상황에서 예외 처리 방식을 어떻게 구성하면 좋을지 실제 구현 예제를 기반으로 정리하였습니다.문제 상황예외가 발생할 때 다음과 같이 @ResponseStatus가 지정되어 있는 커스텀 예외를 사용하고 있었습니다.@ResponseStatus(value = HttpStatus.BAD_REQUEST, reason = "custom error")public class CustomException extends RuntimeException { ..