- 이전 게시글
스프링 오류 페이지
개요
- 이전 게시글에서 서블릿에서 예외를 처리하는 방법에 대해 알아보았다.
- 스프링은 이러한 과정을 모두 기본으로 제공한다.
스프링이 제공하는 오류 페이지 처리 기능
ErrorPage를 자동으로 등록한다.- 기본 오류 페이지 경로:
templates/error,static/error- 상태코드와 예외를 설정하지 않으면 기본 오류 페이지로 사용된다.
- 서블릿 밖으로 예외가 발생하거나,
response.sendError()가 호출되면 모든 오류는/error를 호출하게 된다. - 그리고
BasicErrorController가/error요청을 처리한다.
BasicErrorController라는 스프링 컨트롤러를 자동으로 등록한다.ErrorPage에서 등록한/error를 매핑해서 처리하는 컨트롤러이다.
- 따라서 개발자는 오류 페이지만 등록하면 된다.
BasicErrorController 의 뷰 선택 우선순위
- 뷰 템플릿
resource/templates/error/500.htmlresource/templates/error/5xx.html
- 정적 리소스
resource/static/error/400.htmlresource/static/error/4xx.html
- 적용 대상이 없을 때 뷰 이름 (
error)/resources/templates/error.html
BasicErrorController 의 뷰 선택 규칙
- 해당 경로 위치에 HTTP 상태 코드 이름의 뷰 파일을 넣어두면 된다.
- 뷰 템플릿이 정적 리소스보다 우선순위가 높다.
- 400, 500 처럼 구체적인 것이 5xx처럼 덜 구체적인 것보다 우선순위가 높다.
- 4xx, 5xx 라고 하면 500대, 400대 오류를 처리해준다.
스프링 오류 처리 예시
예시코드 실습을 위해, 이전 게시글에서 작성한
WebServerCustomizer클래스에서@Component애너테이션을 주석처리하자.
오류 뷰 템플릿 1: resources/templates/error/4xx.html
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Title</title>
</head>
<body>
<h1>BasicErrorController 가 호출해준 오류 페이지</h1>
<h1>400대 에러를 처리한다.</h1>
</body>
</html>
오류 뷰 템플릿 2: resources/templates/error/404.html
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Title</title>
</head>
<body>
<h1>BasicErrorController 가 호출해준 오류 페이지</h1>
<h1>404 에러를 처리한다.</h1>
</body>
</html>
오류 뷰 템플릿 3: resources/templates/error/500.html
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Title</title>
</head>
<body>
<h1>BasicErrorController 가 호출해준 오류 페이지</h1>
<h1>500 에러를 처리한다.</h1>
</body>
</html>
결과
-
호출:
http://localhost:8080/sendError
-
호출:
http://localhost:8080/존재하지않는경로
- 본 게시글은 김영한님의 강의를 토대로 정리한 글입니다.
- 더 자세한 내용을 알고 싶으신 분들이 계신다면, 해당 강의를 수강하시는 것을 추천드립니다.