OPEN HYPER STEP
← 목록으로 (Java+Spring)
JAVA · 58 / 69
java
CHAPTER 58 / 69
읽기 약 2
FUNCTION

예외 처리 핸들러


핵심 개념

@ControllerAdvice로 전역 예외를 처리한다. 표준 에러 응답 형식, 커스텀 예외 계층, HTTP 상태 코드 매핑을 실무 수준으로 구현한다.

코드 분석
JAVA📋 코드 (50줄)
// 표준 에러 응답
@Getter
@AllArgsConstructor
public class ErrorResponse {
    private final int status;
    private final String code;
    private final String message;
    private final LocalDateTime timestamp = LocalDateTime.now();
}

// 커스텀 예외 계층
public class BusinessException extends RuntimeException {
    private final ErrorCode errorCode;
    public BusinessException(ErrorCode code) {
        super(code.getMessage());
        this.errorCode = code;
    }
}

@Getter
@RequiredArgsConstructor
public enum ErrorCode {
    USER_NOT_FOUND(404, "USER_001", "사용자를 찾을 수 없습니다"),
    DUPLICATE_EMAIL(409, "USER_002", "이미 사용 중인 이메일입니다"),
    INVALID_TOKEN(401, "AUTH_001", "유효하지 않은 토큰입니다");

    private final int status;
    private final String code;
    private final String message;
}

// GlobalExceptionHandler.java
@RestControllerAdvice
public class GlobalExceptionHandler {
    @ExceptionHandler(BusinessException.class)
    public ResponseEntity<ErrorResponse> handle(BusinessException e) {
        ErrorCode code = e.getErrorCode();
        return ResponseEntity.status(code.getStatus())
            .body(new ErrorResponse(code.getStatus(), code.getCode(), code.getMessage()));
    }

    @ExceptionHandler(MethodArgumentNotValidException.class)
    public ResponseEntity<ErrorResponse> handle(MethodArgumentNotValidException e) {
        String message = e.getBindingResult().getFieldErrors().stream()
            .map(fe -> fe.getField() + ": " + fe.getDefaultMessage())
            .collect(Collectors.joining(", "));
        return ResponseEntity.badRequest()
            .body(new ErrorResponse(400, "VALID_001", message));
    }
}

AI 프롬프트
🤖 AI에게 잘 물어보는 법 — 모델·전략별 프롬프트
Claude

무료: Sonnet 4.6 / Pro $20/mo: Opus 4.6

이 Spring '예외 처리 핸들러' 코드에서
DI 관련 버그·순환 참조·트랜잭션 누수를
찾아서 수정해줘.
ChatGPT

무료: GPT-5.5 / Plus $20/mo: GPT-5.5 Pro

'예외 처리 핸들러'를 Spring Boot 3.x로 구현한
실전 API 코드(컨트롤러+서비스+레포지토리+테스트)를 완성형으로 만들어줘.
Gemini

무료: 2.5 Flash / Pro $19.99/mo: 3.1 Pro

이 Spring '예외 처리 핸들러' 프로젝트의 빈 구조와
의존성 트리를 전체 분석하고
N+1 쿼리·순환 참조·성능 병목을 정리해줘.
Grok

무료: Grok 4.1 / SuperGrok $30/mo

Spring '예외 처리 핸들러' vs Quarkus·Micronaut·Ktor의
동일 기능 구현을 2026년 한국 채용 시장 기준으로
솔직히 비교해줘.

⭐ 이것만 기억하세요
예외 처리 핸들러 이 3가지만 확실히 잡으세요
1.도메인별 커스텀 예외 없이 RuntimeException만 던지면 에러 원인을 구분할 수 없습니다
2.도메인별 예외 클래스를 정의하고, @ControllerAdvice에서 예외별 HTTP 상태 코드와 에러 응답을 매핑합니다
3.다음 챕터에서 입력 데이터를 자동 검증하는 Validation을 배웁니다


공유하기
진행도 58 / 69