TemplateInputException

알파로그·2023년 3월 12일

Error

목록 보기

12/37

Template / Input / Exception

탬플릿 / 입력 / 예외

직역해보면 템플릿 관련해서 입력을 잘못해 발생된 예외임을 예상할 수 있다.

🧩 케이스 1.

✏️ 발단

Spring MVC 동적 View Template 기초 강의를 듣던도중 예외가 발생했다.

TemplateInputException: 
    Error resolving template [hello], 
    template might not exist or might not be accessible by any of the configured Template Resolvers

root cause
- message 를 살펴보면 탬플릿이 존재하지 않거나,
  탬플릿 리졸버에 접근할 수 없다고 하는것 같다.

TemplateInputException: 
    Error resolving template [hello], 
    template might not exist or might not be accessible by any of the configured Template Resolvers

문제의 코드

package hello.springmvc2.basic.response;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.servlet.ModelAndView;

@Controller
public class ResponseViewController {

    @RequestMapping("/response-view-v1")
    public ModelAndView responseViewV1() {

        ModelAndView mav = new ModelAndView("hello").addObject("data", "hello!");

        return mav;
    }
}

✏️ 원인

콘솔 메시지가 제안한 첫번째 원인인 탬플릿이 존재하지 않는것 같다의 의미는
말 그대로 내가 말한 경로에서 “hello.html” 을 찾아봤는데 아무것도 못찾았다는 의미이다.

확인해보니 template/response/hello.html 의 경로에 파일이 있엇다.

✏️ 해결

ModelAndView 의 경로를 "response/hello" 로 바꾸니 문제가 해결되었다.

package hello.springmvc2.basic.response;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.servlet.ModelAndView;

@Controller
public class ResponseViewController {

    @RequestMapping("/response-view-v1")
    public ModelAndView responseViewV1() {

        ModelAndView mav = new ModelAndView("response/hello").addObject("data", "hello!");

        return mav;
    }
}

🧩 케이스 2.

✏️ 발단

wellcome page 를 만들던중 에러가 발생했다.

controller

@Controller
@Slf4j  // Logger
public class HomeController {

    @RequestMapping("/")
    public String home () {
        log.info("home controller");
        return "home";
    }
}

home.html

<!DOCTYPE HTML>
<html xmlns:th="http://www.thymeleaf.org">
<head th:replace="fragments/header :: header">
    <title>Hello</title>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
</head>
<body>
<div class="containera">
    <div th:replace="fragments/bodyHeader :: bodyHeader" />
    <div class="jumbotron"> <h1>HELLO SHOP</h1>
        <p class="lead">회원 기능</p> <p>
            <a class="btn btn-lg btn-secondary" href="/members/new">회원 가입</a>
            <a class="btn btn-lg btn-secondary" href="/members">회원 목록</a> </p>
        <p class="lead">상품 기능</p> <p>
            <a class="btn btn-lg btn-dark" href="/items/new">상품 등록</a>
            <a class="btn btn-lg btn-dark" href="/items">상품 목록</a> </p>
        <p class="lead">주문 기능</p> <p>
            <a class="btn btn-lg btn-info" href="/order">상품 주문</a>
            <a class="btn btn-lg btn-info" href="/orders">주문 내역</a> </p>
    </div>
    <div th:replace="fragments/footer :: footer" />
</div> <!-- /container -->

</body>
</html>

에러 문구 요약

TemplateInputException: 
			An error happened during template parsing 
						(template: "class path resource [templates/home.html]")

ParseException: 
			Error resolving template [fragments/header], 
						template might not exist or might not be accessible by any of the configured Template Resolvers

대략적으로 home.html 템플릿 분석중에 오류가 났고, fragments/header 를 엑세스 할 수 없다고한다.

✏️ 원인 분석

로그는 제대로 찍혀있기 때문에 Controller 의 문제는 아닌것같다.

html 에서 문제가 발생했다는 의미이다.

INFO 14358 --- [nio-8080-exec-1] j.jpashop.controller.HomeController : home controller

html 코드를 살펴보니 th:replace 의 경로와 실제 파일 경로가 다른걸 확인했다.

✏️ 문제 해결

실제 경로의 스펠링을 정확하게 고처주니 정상 작동 되었다.

🧩 케이스 3.

✏️ 발단

Spring MVC 동적 View Template 기초 강의를 듣던도중 예외가 발생했다.

TemplateInputException: 
    Error resolving template [hello], 
    template might not exist or might not be accessible by any of the configured Template Resolvers

root cause
- message 를 살펴보면 탬플릿이 존재하지 않거나,
  탬플릿 리졸버에 접근할 수 없다고 하는것 같다.

TemplateInputException: 
    Error resolving template [hello], 
    template might not exist or might not be accessible by any of the configured Template Resolvers

문제의 코드

package hello.springmvc2.basic.response;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.servlet.ModelAndView;

@Controller
public class ResponseViewController {

    @RequestMapping("/response-view-v1")
    public ModelAndView responseViewV1() {

        ModelAndView mav = new ModelAndView("hello").addObject("data", "hello!");

        return mav;
    }
}

✏️ 원인

확인해보니 template/response/hello.html 의 경로에 파일이 있엇다.

✏️ 해결

ModelAndView 의 경로를 "response/hello" 로 바꾸니 문제가 해결되었다.

package hello.springmvc2.basic.response;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.servlet.ModelAndView;

@Controller
public class ResponseViewController {

    @RequestMapping("/response-view-v1")
    public ModelAndView responseViewV1() {

        ModelAndView mav = new ModelAndView("response/hello").addObject("data", "hello!");

        return mav;
    }
}