@ControllerAdvice HTTP 405 처리

안녕하세요, 인프런 AI 인턴입니다.
님의 질문에 대한 답변입니다.

@ControllerAdvice를 사용한 전역 예외 처리는 컨트롤러 레이어에서 발생하는 예외에 대해 효율적으로 대응할 수 있는 방법을 제공합니다. 특히 패키지명을 명시하여 특정 컨트롤러 또는 컨트롤러 그룹에 대한 예외 처리를 할당할 수 있습니다. 그러나, HTTP 405 에러(메서드 불허 오류)의 경우 핸들러를 찾지 못할 때 발생하는 것으로, 이는 @ControllerAdvice의 적용 범위와는 조금 다른 문제입니다.

HTTP 405 에러는 클라이언트가 서버에게 요청한 HTTP 메서드가 해당 리소스에서 허용되지 않을 때 발생합니다. 예를 들어, 리소스에서만 POST 요청을 허용하는데 클라이언트가 GET 요청을 하면, 서버는 405 응답을 반환합니다.

이러한 문제에 대한 해결 방법으로, 먼저 @ControllerAdvice를 전역으로 설정하여 어플리케이션 전반에 해당하는 예외 처리를 담당하도록 구성해보는 것이 하나의 방법입니다. 즉, @ControllerAdvice 애너테이션에 패키지 경로를 명시하지 않고 적용하면 어플리케이션의 모든 컨트롤러에서 발생하는 예외에 대해 이를 처리할 수 있게 됩니다.

또한, Spring Boot에서는 기본적으로 /error 매핑을 통해 모든 에러를 처리하는 방식을 제공합니다. 따라서 @ControllerAdvice 내에서 특정 에러를 커스터마이징하고 싶다면, 해당 클래스를 구현하고 적절한 핸들러 메소드를 추가하는 방식으로 진행할 수 있습니다. 예를 들어, ErrorController 인터페이스를 구현하거나, ErrorAttributes 타입의 빈을 추가하여 기본 에러 처리 방식을 변경할 수 있습니다.

import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;

@ControllerAdvice
public class GlobalControllerAdvice {

  @ExceptionHandler(Exception.class)
  public String handleException() {
    // 예외 처리 로직
    return "error";
  }
}

전역으로 설정된 @ControllerAdvice를 통해 다양한 예외, 특히 HTTP 405와 같은 경우에도 커스텀 에러 페이지로 유도하거나 에러 정보를 반환하는 등의 처리를 구현할 수 있습니다.

님께서 문의하신 405 에러 처리와 관련하여, 전역 @ControllerAdvice 설정이나 Spring Boot의 기본 /error 처리 로직을 적극 활용해보시길 권장드립니다.