JSP & CUBRID DB 한글 깨짐, 아이콘 해결 삽질기

혹시 JSP와 CUBRID DB 연동 중 한글 깨짐과 아이콘 문제로 밤샘 작업하신 적 있으신가요? 이 글은 제가 겪었던 삽질 경험을 바탕으로, 문제 해결 과정을 쉽고 명확하게 정리했습니다. 단 5분 투자로 여러분의 소중한 시간을 절약해 보세요!

 

JSP와 CUBRID DB를 사용하다 보면 흔히 겪는 문제가 있습니다. 바로 한글 깨짐 현상과 특정 아이콘이 제대로 표시되지 않는 문제인데요. 원인은 다양하지만, 대부분 인코딩 설정과 관련이 깊습니다. 제가 해결했던 방법들을 자세히 공유해 드릴게요.

1. **한글 깨짐 문제 해결:**




- **CUBRID DB 캐릭터셋 확인:** CUBRID Manager에서 DB 캐릭터셋이 UTF-8로 설정되어 있는지 확인합니다. `SHOW VARIABLES LIKE 'character_set%';` 쿼리를 실행하여 확인 가능합니다.




- **JSP 페이지 인코딩 설정:** JSP 페이지 상단에 `<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>` 코드를 추가하여 UTF-8 인코딩을 명시합니다.




- **JDBC URL 설정:** JDBC 연결 URL에 `characterEncoding=UTF-8` 옵션을 추가합니다. 예: `jdbc:cubrid:localhost:33000:demodb:?charset=UTF-8`




- **필터(Filter) 사용:** 모든 요청에 대해 UTF-8 인코딩을 적용하는 필터를 생성하여 `web.xml`에 등록합니다. 이 방법은 프로젝트 전체에 일괄 적용하기에 효과적입니다.




2. **아이콘 깨짐 문제 해결:**




- **웹 서버 MIME 타입 설정:** 웹 서버(Tomcat 등)의 `web.xml` 파일에 아이콘 파일 확장자에 대한 MIME 타입을 추가합니다. 예를 들어, `.woff` 파일에 대한 `mime-mapping`을 추가해야 합니다.




- **CSS 파일 경로 확인:** CSS 파일에서 아이콘 폰트 파일의 경로가 올바르게 지정되었는지 확인합니다. 상대 경로 또는 절대 경로를 정확하게 설정해야 합니다.




- **폰트 파일 접근 권한 확인:** 웹 서버가 폰트 파일에 접근할 수 있는 권한이 있는지 확인합니다. 필요한 경우 파일 권한을 변경해야 합니다.




- **브라우저 캐시 삭제:** 브라우저 캐시에 이전 버전의 CSS 또는 폰트 파일이 남아있을 수 있으므로, 캐시를 삭제하고 다시 시도해 봅니다.

**추가 팁:** CUBRID DB 버전과 JDBC 드라이버 버전을 최신 버전으로 유지하는 것이 좋습니다. 이전 버전에서는 인코딩 관련 버그가 존재할 수 있습니다.

 

결론적으로, JSP와 CUBRID DB 사용 시 한글 깨짐 및 아이콘 문제는 인코딩 설정과 파일 경로, 웹 서버 설정 등을 꼼꼼히 확인하면 해결할 수 있습니다. 혹시 CUBRID DB 쿼리 튜닝에 어려움을 겪고 계신다면, CUBRID에서 제공하는 쿼리 플래너를 활용해 보세요. 쿼리 성능 개선에 큰 도움이 될 겁니다.