URL이 이상해요! Java와 Spring 중 범인은 누구?

간단 소개

카카오페이 알림피드 장애 원인 분석 및 해결 과정: Java URI와 Spring UriComponentsBuilder 클래스 간 불일치 해결.

AI Summary

장애 발생 원인 분석
- 카카오페이 알림피드 서비스에서 URL 가공 중 장애 발생, 원인은 Java URI 클래스와 Spring UriComponentsBuilder 클래스 간의 불일치.
- OS 알림 센터와 알림피드의 메시지 랜딩 동작 차이로 인해 URL 파라미터 제거 로직 추가 중 문제 발생.
문제 해결 과정 및 핵심 내용
- UriComponentsBuilder#fromUri 메서드가 java.net.URI의 host 변수를 제대로 처리하지 못하는 문제 발견.
- java.net.URI는 RFC 2396을 따르지만, UriComponentsBuilder는 RFC 3986을 따름. RFC 3986은 host에 특수문자(_)를 허용.
- 해결책으로 UriComponentsBuilder#fromUriString 메서드를 사용하여 URI를 파싱, RFC 3986에 따라 정보를 누락 없이 처리.
재발 방지 및 교훈
- 라이브러리 내부 구현에 대한 이해 부족으로 발생한 장애임을 인지하고, 사내 공유 및 소나큐브 커스텀 룰 등록을 통해 재발 방지.
- 라이브러리 사용 시 내부 동작에 대한 깊이 있는 이해가 중요함을 강조.