Java 개발자들의 예외 처리 가이드라인 실태 조사

초록

본 연구는 GitHub 상위 스타 프로젝트의 Java 개발자를 대상으로 설문과 인터뷰를 수행해, 예외 처리에 관한 가이드라인의 존재 여부, 형태(명시·암묵), 전파·검증 방법을 파악한다. 70% 이상의 프로젝트가 예외 처리 규칙을 가지고 있으나, 대부분이 문서화되지 않은 암묵적 규칙이며, 코드 리뷰와 검사 과정을 통해 준수 여부를 확인한다. 총 48개의 구체적 가이드라인이 7개 카테고리로 분류되었다.

상세 분석

이 논문은 예외 처리라는 Java 언어의 핵심 메커니즘이 실제 현업에서 어떻게 관리되고 있는지를 정성적·양적 방법으로 조명한다. 연구 설계는 두 단계로 나뉜다. 첫 번째 단계에서는 7명의 숙련 개발자를 대상으로 반구조화 인터뷰를 진행해 예외 처리에 관한 초기 인사이트를 도출하고, 이를 바탕으로 설문지를 설계한다. 두 번째 단계에서는 GitHub에서 스타 수가 높은 5 000개 이상의 레포지터리를 필터링한 뒤, 최근 활발히 커밋한 863명의 Java 개발자에게 설문을 발송해 98개의 유효 응답(응답률 11%)을 확보하였다.

응답자들의 경력 분포는 평균 10년 이상이며, 77%가 개발 과정에서 예외 처리 코드를 읽고 쓰거나 고민하는 데 일정 시간을 할애한다고 답했다. 설문 문항은 예외 신호(signal), 포착(catch), 처리(action) 세 영역에 대한 가이드라인 존재 여부와 구체적 내용, 그리고 가이드라인의 전파·검증 메커니즘을 묻는다.

결과적으로 예외 신호에 대한 가이드라인이 70%의 프로젝트에 존재하고, 포착은 51%, 처리는 59%에서 확인되었다. 그러나 이들 규칙 중 명시적(문서화된) 규칙은 각각 16%, 12%, 19%에 불과하고, 대부분이 암묵적(구두 혹은 관행) 형태였다. 이는 개발팀이 공식적인 정책보다는 경험 기반의 관행에 의존하고 있음을 시사한다.

코드와 가이드라인의 일치성을 검증하는 방법으로는 코드 리뷰(53%), 정적 분석 도구(38%), CI 파이프라인 내 검증(22%) 등이 제시되었으며, 다수는 복합적인 방법을 활용한다. 전파 방식은 리드 개발자·팀 리더의 구두 설명(45%), 레포지터리 위키·README(31%), 코드 주석(24%) 등으로 다양했다.

핵심 가이드라인은 7개의 상위 카테고리(신호, 포착, 처리 행동, 체크/언체크 선택, 커뮤니케이션, 로깅·모니터링, 테스트)로 정리되었으며, 총 48개의 세부 규칙이 도출되었다. 예를 들어 “Checked 예외는 가능한 한 상위 레이어에서 처리하고, RuntimeException은 서비스 경계에서만 전파한다”, “예외를 잡은 뒤 반드시 로그를 남기고, 복구 가능한 경우 재시도 로직을 구현한다” 등이 있다.

연구의 의의는 다음과 같다. 첫째, 기존 문헌이 주로 코드 수준의 패턴·버그를 분석했지만, 본 연구는 개발자 인식·프로세스 차원에서 예외 처리 관행을 조명함으로써 실무와 학계 사이의 격차를 메운다. 둘째, 암묵적 규칙이 다수인 현 상황은 문서화·표준화의 필요성을 강조한다. 셋째, 코드 리뷰와 정적 분석이 주요 검증 수단으로 활용된다는 점은 자동화 도구와 리뷰 문화가 예외 처리 품질 향상에 핵심 역할을 할 수 있음을 보여준다. 마지막으로, 48개의 구체적 규칙은 다른 조직이 자체 가이드라인을 설계하거나 기존 정책을 평가할 때 베이스라인으로 활용될 수 있다.

이러한 인사이트는 소프트웨어 품질 관리, 교육 커리큘럼 설계, 그리고 IDE·CI 도구에 내장될 수 있는 예외 처리 체크리스트 개발 등에 직접적인 활용 가치를 제공한다.