워드프레스·데이터베이스 한글이 `성명`처럼 깨졌을 때

어떤 증상인가요

INSERT INTO wp_posts (post_title) VALUES ('한글 사랑 서울');

INSERT INTO wp_posts (post_title) VALUES ('한글 사랑 서울');

원인은 어디에 있나요

워드프레스는 글을 UTF-8로 저장합니다. 그런데 오래된 설치본은 테이블을 latin1로 만들었거나 latin1로 접속하는 경우가 많습니다. 쓰기와 읽기에서 같은 실수를 하는 동안에는 아무도 눈치채지 못합니다. 새 서버로 옮기거나, phpMyAdmin으로 백업하거나, 접속 문자 집합을 바꾸는 순간 모든 한글이 한꺼번에 깨집니다.

• wp-config.php의 DB_CHARSET이 latin1이거나 테이블과 맞지 않는다.
• 덤프를 latin1로 내보내고 utf8mb4로 가져왔다(또는 그 반대).
• 플러그인이나 가져오기 스크립트가 이미 깨진 텍스트를 한 번 더 변환했다. 이것이 이중 깨짐입니다.

백업 파일 복구하기

1. 무엇이든 바꾸기 전에 데이터베이스를 백업합니다.
2. 문제가 있는 테이블을 .sql 파일로 내보냅니다. phpMyAdmin도 되고, mysqldump --default-character-set=utf8mb4도 됩니다.
3. 위 입력란에 파일을 끌어다 놓습니다. Mojibuster는 깨진 부분만 고치고 바뀐 곳을 모두 보여 줍니다.
4. 복구된 파일을 내려받아 utf8mb4로 새 테스트용 데이터베이스에 가져옵니다.
5. 사이트를 확인하고, 문제가 없으면 운영 데이터베이스에 가져옵니다.

덤프는 업로드되지 않습니다. 덤프에는 보통 회원 계정, 이메일 주소, 댓글이 들어 있으므로 중요한 점입니다.

직렬화된 데이터 주의

워드프레스는 일부 설정을 wp_options와 wp_postmeta에 s:6:"한글"; 같은 PHP 직렬화 값으로 저장합니다. 숫자는 글자 수가 아니라 바이트 수입니다. 깨진 글자를 되돌리면 길이가 맞지 않게 되어 워드프레스가 그 값을 버립니다. 그러니 wp_posts, wp_comments, wp_terms 같은 본문 테이블을 먼저 복구하세요. 옵션 값은 길이까지 갱신해 주는 WP-CLI의 wp search-replace가 더 알맞습니다.

MySQL에서 원인 바로잡기

• 테이블과 접속을 utf8mb4로 바꾸고 wp-config.php에 define('DB_CHARSET', 'utf8mb4');를 설정합니다.
• latin1 열에 UTF-8 바이트가 들어 있다면 바로 변환하지 마세요. 한 번 더 인코딩됩니다. 보통은 이진 형식을 거칩니다. 먼저 MODIFY … LONGBLOB, 그다음 MODIFY … LONGTEXT CHARACTER SET utf8mb4입니다.
• 모든 변경은 먼저 데이터베이스 복사본에서 시험하세요.

자주 묻는 질문

관련 안내

• 한글 깨짐 복구 도구 텍스트와 파일의 깨진 한글을 복구합니다.
• 엑셀 CSV 한글 깨짐 엑셀에서 연 CSV의 한글이 깨질 때.
• 자막 한글 깨짐 SRT·VTT·SMI 자막의 깨진 한글을 복구합니다.
• 글자 깨짐이란 글자 깨짐의 뜻과 원인, 대표적인 유형을 설명합니다.
• 이중 깨짐 한 번 깨진 글자가 한 번 더 깨진 경우.
• 한글 대신 물음표 한글 대신 ?나 �가 보일 때, 살릴 수 있는 것과 없는 것.
• URL 인코딩 문자 한 대신 %ED%95%9C가 보일 때: 링크와 폼의 코드를 읽을 수 있게 되돌립니다.
• MySQL 한글 깨짐 테이블, 접속, 가져오기 문자셋을 utf8mb4로 맞춥니다.
• 아웃룩(Outlook) 메일과 연락처 내보내기의 깨진 한글을 고칩니다.
• PowerShell 한글 깨짐 PowerShell 5.1·7의 -Encoding, 콘솔, 스크립트 파일.
• pandas 한글 깨짐 read_csv, to_csv, open(), requests 의 encoding.
• Notepad++ 한글 깨짐 인코딩 선택과 변환, 결정적인 차이.
• 고객 데이터·CRM CRM·ERP 고객 목록을 업로드 없이 복구합니다.
• EUC-KR → UTF-8 오래된 한글 파일을 UTF-8로 변환합니다.
• 자소 분리 합치기 맥에서 풀린 ㅎㅏㄴㄱㅡㄹ을 완성형 한글로 합칩니다.