WordPress・データベースの日本語が文字化けしたときの直し方

どんな症状か

INSERT INTO wp_posts (post_title) VALUES ('縺薙ｓ縺ｫ縺｡縺ｯ 譌･譛ｬ');

INSERT INTO wp_posts (post_title) VALUES ('こんにちは 日本');

原因はどこにあるか

WordPress は文字を 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. サイトの表示を確認し、問題なければ本番のデータベースに取り込みます。

ダンプはアップロードされません。ダンプにはユーザーアカウント、メールアドレス、コメントが含まれるため、これは重要な点です。

シリアライズされたデータに注意

WordPress は一部の設定を wp_options や wp_postmeta に、s:6:"日本"; のような PHP のシリアライズ形式で保存します。数字は文字数ではなくバイト数です。化けた文字を元に戻すと長さが合わなくなり、WordPress はその値を破棄します。そのため、まず 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 とバイナリ型を経由します。
• すべての変更は、まずデータベースのコピーで試してください。

よくある質問

関連ガイド

• 文字化け修正ツール テキストやファイルの文字化けを直します。
• Excel の CSV 文字化け Excel で開いた CSV が文字化けするとき。
• 字幕の文字化け SRT・VTT・ASS 字幕の文字化けを直します。
• 文字化けとは 文字化けの意味・原因・よくあるパターンを解説します。
• 二重の文字化け 一度文字化けしたテキストが、もう一度化けた状態。
• 文字が ? や � になる 日本語が ? や � になるとき。直せる場合と直せない場合。
• URLエンコード文字 %E3%81%82 を あ に戻します。リンクやフォームの文字コードを読める文字に。
• MySQL の文字化け テーブル・接続・インポートの文字コードをそろえます。
• Outlook メールや連絡先エクスポートの文字化けを直します。
• PowerShell の文字化け 5.1 と 7 の -Encoding、コンソール、スクリプトファイル。
• pandas の文字化け read_csv・to_csv・open() の encoding 指定。
• Notepad++ の文字化け 文字コードの「選択」と「変換」の違い。
• 顧客データ・CRM CRM や基幹システムの顧客リストを、アップロードせずに修復。
• Shift_JIS → UTF-8 古い日本語ファイルを UTF-8 に変換します。
• 濁点の分離を直す Mac で分かれた濁点（か゛）を 1 文字に戻します。