[에러 일기] circular view path [error]: would dispatch back to the current handler URL [/error] again. Check your ViewResolver setup thymeleaf

👉문제 상황

스프링 부트의 HandlerExceptionResolver를 활용하는 실습 과정에서 위의 오류를 마주했다.

@Slf4j
public class UserExceptionResolver implements HandlerExceptionResolver {

	private final ObjectMapper objectMapper = new ObjectMapper();

	@Override
	public ModelAndView resolveException(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) {
		try {
			if (ex instanceof UserException) {
				log.error("UserException resolver to 400");

				// [1]. application/json
				String a = request.getHeader("accept");
				response.setStatus(HttpServletResponse.SC_NOT_FOUND);

				if ("application/json".equals(a)) {
					Map<String, Object> errorResult = new HashMap<>();
					errorResult.put("ex", ex.getClass());
					errorResult.put("message", ex.getMessage());

					// errorResult(객체) → 문자
					String result = objectMapper.writeValueAsString(errorResult);

					response.setContentType("application/json");
					response.setCharacterEncoding("utf-8");
					response.getWriter().write(result);
					return new ModelAndView();
				} else {
					// [2]. text/html
					ModelAndView modelAndView = new ModelAndView();
					// Thymeleaf 의존성 있어야 ModelAndView로 뷰 네임을 찾을 수 있음
					modelAndView.setViewName("error/404");
					return modelAndView;
				}
			}
		} catch (IOException e) {
			log.error("resolver ex", e);
		}
		return null;
	}
}

• 요청 헤더가 application/json 타입의 경우 리턴 타입이 빈 ModelAndView로 되어 있는데 이 빈 ModelAndView를 리턴하면 아무런 뷰도 보여지지 않게 되고 WAS에 예외가 그대로 전달이 된다.
• 요청 헤더가 text/html 타입의 경우 리턴 타입을 스프링이 기본적으로 제공하는 예외 경로인 /error로 매핑하여 그 하위에 있는 오류 페이지인 404.html이 보여지게끔 하는 과정에서 제목과 같은 예외가 발생했다.
• build.gradle에 타임리프 의존성을 추가하지 않아 뷰 네임을 찾을 수 없어 발생한 에러였다.
• build.gradle에 아래와 같이 타임리프 의존성을 추가해주면 된다.

implementation 'org.springframework.boot:spring-boot-starter-thymeleaf'

♻️개선 결과

• 요청 헤더의 타입이 application/json인 경우 결과

• 요청 헤더의 타입이 text/html인 경우 결과