# Spring Boot 전역 예외 처리 + 에러 페이지 후 리다이렉트 구현 정리

🍃Spring/Exception

# Spring Boot 전역 예외 처리 + 에러 페이지 후 리다이렉트 구현 정리

뭉지맘 2025. 5. 29. 11:08

1. 목표

컨트롤러에서 예외 발생 시, 사용자가 에러 메시지를 확인한 후 일정 시간 뒤 자동으로 / 메인 페이지로 이동하도록 구성
커스텀 예외 CustomException과 일반 예외 모두 처리

뷰단 템플릿은 타임리프 사용함.

2. 디렉토리 구조

src/
 └── main/
     └── java/
         └── com.example.demo/
             ├── controller/
             │    └── TestController.java
             └── global/
                  └── exception/
                      ├── CustomException.java
                      └── GlobalExceptionHandler.java
     └── resources/
         ├── templates/
         │    ├── custom-error.html
         │    └── index.html
         └── application.properties

3.코드 구성

CustomException.java

package com.example.demo.global.exception;

public class CustomException extends RuntimeException{
    public CustomException(String message) {
        super(message);
    }
}

TestController.java

package com.example.demo.controller;

import com.example.demo.global.exception.CustomException;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;

@Controller
public class TestController {

    @GetMapping("/")
    public String index() {
        return "index";
    }

    @GetMapping("/test/error")
    public String throwCustomError() {
        throw new CustomException("테스트용 사용자 정의 예외입니다.");
    }

    @GetMapping("/test/null")
    public String throwNullPointer() {
        String x = null;
        x.length(); // NullPointerException
        return "index";
    }
    
    // 404 강제 유도 (없는 페이지로 리다이렉트)
    @GetMapping("/test/404")
    public String force404() {
        return "redirect:/없는페이지";
    }

    // 500 강제 유도 (Exception 발생)
    @GetMapping("/test/500")
    public String force500() {
        throw new RuntimeException("강제로 발생시킨 500 서버 에러입니다.");
    }
}

GlobalExceptionHandler.java

package com.example.demo.global.exception;

import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.*;
import org.springframework.web.servlet.ModelAndView;
import org.springframework.web.servlet.NoHandlerFoundException;

@ControllerAdvice
public class GlobalExceptionHandler {
    /*@ExceptionHandler(CustomException.class)
    public ResponseEntity<String> handleCustomException(CustomException ex){
        return new ResponseEntity<>(ex.getMessage(), HttpStatus.BAD_REQUEST);
    }

    @ExceptionHandler(Exception.class)
    public ResponseEntity<String> handleException(Exception ex){
        return new ResponseEntity<>("서버 오류가 발생했습니다:" + ex.getMessage(), HttpStatus.INTERNAL_SERVER_ERROR);
    }*/

    @ExceptionHandler(CustomException.class)
    public ModelAndView handleCustomException(CustomException ex) {
        ModelAndView mav = new ModelAndView("custom-error"); // templates/custom-error.html
        mav.addObject("message", ex.getMessage());
        mav.addObject("redirectUrl", "/");
        mav.addObject("delay", 3); // 3초 뒤 이동
        return mav;
    }

    @ExceptionHandler(Exception.class)
    public ModelAndView handleGeneralException(Exception ex) {
        ModelAndView mav = new ModelAndView("custom-error");
        mav.addObject("message", "예기치 못한 오류가 발생했습니다: " + ex.getMessage());
        mav.addObject("redirectUrl", "/");
        mav.addObject("delay", 5);
        return mav;
    }

    @ExceptionHandler(NoHandlerFoundException.class)
    public ModelAndView handle404(NoHandlerFoundException ex) {
        ModelAndView mav = new ModelAndView("custom-error");
        mav.addObject("message", "존재하지 않는 페이지입니다. 입력한 주소를 다시 확인해주세요.");
        mav.addObject("redirectUrl", "/");
        mav.addObject("delay", 5);
        return mav;
    }

}

custom-error.html

<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
    <meta charset="UTF-8" />
    <title>오류 발생</title>
    <meta http-equiv="refresh"
          th:content="${delay} + ';url=' + ${redirectUrl}" />
</head>
<body>
    <h2>죄송합니다. 문제가 발생했습니다.</h2>
    <p>관리자에게 문의해주세요.</p>
    <p th:text="'에러 내용: ' + ${message}"></p>
    <p th:text="'잠시 후 ' + ${delay} + '초 뒤에 메인 페이지로 이동합니다.'"></p>
    <p><a th:href="${redirectUrl}">지금 바로 이동하기</a></p>
</body>
</html>

index.html

<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
    <meta charset="UTF-8" />
    <title>메인 페이지</title>
</head>
<body>
    <h1>홈(index) 페이지입니다</h1>
    <p>이 페이지는 에러 발생 후 리다이렉트되는 곳입니다.</p>
</body>
</html>

application.properties

spring.thymeleaf.prefix=classpath:/templates/
spring.thymeleaf.suffix=.html
spring.thymeleaf.mode=HTML
spring.thymeleaf.encoding=UTF-8
spring.thymeleaf.cache=false

4.테스트 방법

/test/error: 사용자 정의 예외 발생
/test/null: 일반 예외 (NullPointerException) 발생
둘 다 에러 메시지를 출력하고, 3초 후 메인 페이지(/)로 이동

5. 결론

이 방식은 Spring Boot MVC 환경에서 사용자에게 친절하게 예외를 알리고, 자동으로 안전한 경로로 유도할 수 있는 예외 처리 방법이다.
메시지, 이동 경로, 지연 시간 등을 상황에 맞게 확장 가능하며, 향후 공통 에러 응답 포맷으로 발전시킬 수 있다.