application.properties 한글 깨짐
프로젝트를 새로 생성해서 application.properties에 데이터베이스 연결 정보를 작성하고 깃허브에 Push 작업을 했는데
💢 다음날 확인해 보니 한글로 작성한 주석이 깨진 상태로 깃허브에 올라가 있던걸 발견했다

인텔리제이에서도 당연히 한글이 깨진 상태였다...
한글만 깨지는 걸로 봐선 인코딩 문제가 분명하다고 생각했고 설정에 들어가 인코디 설정을 확인했습니다
IDE 인코딩 설정으로 해결

프로퍼티 파일에 대한 디폴트 인코딩이 ISO-8859-1로 되어 있어서 문제가 발생한 걸로 보인다
검색해 보니 UTF-8은 거의 모든 문자를 지원하는 반면 ISO-8859-1 인코딩은 한글을 지원하지 않아서 한글 깨짐이 발생한다고 한다

간단하게 프로퍼티 파일에 대한 디폴트 인코딩을 한글을 지원하는 UTF-8로 변경하여 적용시켜 주면 됩니다
.gitattributes
# .properties 파일 한글 깨짐 방지 (UTF-8)
*.properties text working-tree-encoding=UTF-8
GitHub에 프로젝트를 올릴 때 properties 한글 깨짐을 방지하기 위해 .gitattributes에 코드를 추가하여 Push 해줍니다
이후 application.properties에서 깨진 주석을 다시 한글로 작성하고 깃허브에 올려줍니다

깃허브에 가서 확인해 보면 한글이 깨지지 않고 정상적으로 나오는 걸 볼 수 있습니다
요약
1. .properties 파일을 기본 인코딩이 ISO-8859-1로 사용되며 한글을 지원하지 않아 한글을 작성하면 깨짐이 발생
2. IDE 설정에서 프로퍼티 디폴트 인코딩을 한글도 지원하는 UTF-8로 변경
3. .gitattributes 파일에 한글 깨짐 방지 코드를 작성하여 2차 방지
'Back-end > Spring' 카테고리의 다른 글
[Spring] CORS이 무엇이며 Spring Boot에서 해결 하는 방법 (0) | 2025.04.10 |
---|---|
[Spring] SpringBoot 3버전 Swagger 적용 및 활용 (0) | 2025.04.06 |
[IntelliJ] 인텔리제이 Ultimate 버전 Spring Boot 프로젝트 생성 방법 (0) | 2025.03.14 |
[IntelliJ] 인텔리제이 Ultimate 버전 설치 및 학생용 라이선스 발급 방법 (2) | 2024.12.25 |
[Spring] Spring Framework의 정의와 특징에 대해 알아보자 (Ioc,DI,AOP) (0) | 2024.09.29 |