SpringBoot 버전 이슈로 Mustache 한글 깨짐

결론으로 바로 가기

 

먼저 이 문제는 '스프링 부트와 AWS로 혼자 구현하는 웹 서비스'라는 책을 실습하는 과정에서 마주친 상황이다.

책은 몇 년 전에 지어진 기준이라 자바나 스프링부트의 버전이 낮게 되어있다. 그렇지만 그 당시 버전보다는 지금 상황에서 안정된 최신 버전으로 변경사항은 고치며 해보고 싶어 최신버전으로 진행했다.

• Spring Boot : 3.1.2
• Java : 17
• Gradle : 8.2.1

 

문제 상황

한글 깨짐

스프링 부트에서 공식 지원하는 템플릿 엔진 Mustache를 사용하던 중 이렇게 한글이 깨지는 현상이 발생했다.

 

결론

스프링 부트 2.7.X 버전 이상부터는 한글 깨짐이 발생한다.

스프링 부트 버전을 2.7.0 이하로 낮추거나 버전을 낮추지 못한다면

//aplication.properties

server.servlet.encoding.force-response=true

// application.yml

server:
  servlet:
    encoding:
      force-response: true

이 설정을 추가해 주면 해결할 수 있다.

 

 

 

언제나 잘못된 설명이나 부족한 부분에 대한 피드백은 환영입니다🤍