스프링 부트를 사용하다보면 사람들이 착각하는 게 하나 있다.

스프링 부트로 개발하면서 부딪치게 되는 문제가 모두 스프링 부트에서 발생한다고 생각한다. ㅡ_-)>

실제 문제발생 부분은 본인이 추가한 모듈(JPA라면 스프링 Data JPA와 Hibernate, Web이라면 Spring 5 Servlet Stack, 보안 관련 부분은 Spring Security 5)에 기인한다.

스프링 부트를 이용한 개발 중에 발생한 문제에 대해 묻고 싶다면,
자신이 사용한 스프링부트 버전과 문제가 발생한 기능과 관련된 프레임워크나 라이브러리 버전을 거론해야 한다.

"무턱대고 스프링 부트로 개발하는데 문제가 발생했어요." 라고 묻는 건 잘못된 질문법이다.

자신의 문제를 풀어달라고 하면서, 스무고개 식으로 질문하는 행태를 보고 있으면... 답변해주고 싶지가 않다.

스프링 부트에서 제공하는 모듈을 사용하려면, 그 모듈이 제공하는 기능에 대해서 공부해야 한다.

JPA를 사용한다면, Spring Data JPA와 하이버네이트를 공부해야 하고, 웹기능을 개발한다면 Spring Servlet Stack을 봐야 하고, 비동기 기능을 개발한다면 Spring Reactive Stack을 봐야하는데...

자신이 사용하는 기능에 대한 자기학습없이 무턱대로 코딩부터 하는 습관은 좋지않다.


어떤 기능을 학습함에 있어서 기능을 구현해보면서 학습하는 것은 중요하다. 그러나 그에 앞서서 사용하는 기술의 기본적인 지식과 동작방식을 살펴보자.


스프링부트 기본 에러페이지는 ‘whitelabel’ error page 이다. 이와 관련된 내용은 ErrorMvcAutoConfiguration 을 살펴보면 찾아볼 수 있다.

private final SpelView defaultErrorView = new SpelView(
"<html><body><h1>Whitelabel Error Page</h1>"
+ "<p>This application has no explicit mapping for /error, so you are seeing this as a fallback.</p>"
+ "<div id='created'>${timestamp}</div>"
+ "<div>There was an unexpected error (type=${error}, status=${status}).</div>"
+ "<div>${message}</div></body></html>");

이 기본적인 화이트레이블 페이지 대신에 사용자가 지정한 에러페이지로 변경이 가능하다. 이를 위해서는

server.error.include-stacktrace=never # When to include a "stacktrace" attribute.
server.error.path=/error # Path of the error controller.
server.error.whitelabel.enabled=true # Enable the default error page displayed in browsers in case of a server error.

위 세가지 속성에 대한 조작을 해야 한다. 우선 사용자지정 에러페이지를 사용하기 위해서는 화이트레이블 출력을 비활성화해야 한다.

server.error.whitelabel.enabled=false

로 변경한다. 그리고 에러페이지에서 발생한 에러의 스택트레이스를 출력하기 위해서는 server.error.include-stacktrace 을 never 이외의 것으로 변경해야 한다.

server.error.include-stacktrace=always or on_trace_param

이와 관련된 값은 ErrorProperties 를 살펴보면 된다.

사용가능한 속성들을 템플릿(Thymeleaf) 에 적용해본 예다.

<div class="container error-404">
    <h1 th:text="${status}">Status</h1>
    <h2>Houston, we have a problem([[${error}]])</h2>
    <p th:text="${message}"> Error Message</p>
    <p>
        <a href="index.html" th:href="@{/}" class="btn red btn-outline"> Return home </a>
        <br>
    </p>
    <div>
        <label>Time Stamp</label>
        <div th:text="${timestamp}"></div>
    </div>
    <div>
        <label>Exception name</label>
        <div th:text="${exception}"></div>
    </div>
    <div>
        <label>Trace</label>
        <div th:utext="${trace}"></div>
    </div>
</div>

화면에 출력가능한 속성값들에 대해서는 DefaultErrorAttributes 를 살펴보면 이용할 수 있는 정보를 확인가능하다. 그러면 다음과 같은 화면을 볼 수 있게 된다.



+ Recent posts