API 응답 오류 디버깅 경험을 로그 분석→재현→수정→예방 순서로 서술
팀 프로젝트에서 외부 API 연동 모듈이 특정 조건에서만 500 오류를 반환하는 문제를 겪었습니다. 오류 분석은 먼저 로그에서 재현 패턴을 찾는 것부터 시작했습니다. 랜덤하게 보였지만 로그를 타임스탬프 기준으로 정렬하니 요청이 몰리는 시간대와 오류 발생이 일치하는 게 보였습니다. 재현을 위해 로컬에서 부하 조건을 시뮬레이션하는 간단한 스크립트를 짰고, 결국 커넥션 풀 한도 초과가 원인임을 확인했습니다. 대응은 커넥션 풀 설정값을 환경 변수로 분리하고 타임아웃 처리를 추가했습니다. 팀 협업으로는 제가 원인 분석을 맡고, 다른 팀원이 해당 모듈 코드 리뷰를 병렬로 진행해서 수정 시간을 절반으로 줄였습니다. 교훈은 오류는 재현 조건을 먼저 명확히 해야 빠르게 범위를 좁힐 수 있다는 것입니다.