MySQL・phpMyAdmin の文字化けを直す

MySQL で文字コードが関わる 3 か所

• 列・テーブル： データを保存する文字コードです。utf8mb4 のほか、古いシステムでは latin1、sjis、cp932、ujis（EUC-JP）も使われています。
• 接続： アプリと MySQL がやり取りする文字コードです。SET NAMES utf8mb4 や接続設定で指定します。
• ファイル： インポートやエクスポートで使う文字コードです。phpMyAdmin ではインポート・エクスポート画面でファイルの文字セットを選べます。コマンドラインで結果が化ける場合は PowerShell の文字化け も参考になります。

3 か所のどれかが食い違うと文字が化けます。症状は大きく 2 種類に分かれ、直せるかどうかも違います。

日本語が ???? になる場合

列や接続の文字コードが日本語を表せないと、MySQL は文字を ? に置き換えて保存します。よくあるのは、列や接続が latin1 のままになっているケースです。接続が cp932 や sjis の場合も、CP932 にない絵文字などは ? になります。

utf8（実体は 3 バイトまでの utf8mb3）の列に絵文字や 𠮷 のような 4 バイトの文字を入れると、Incorrect string value エラーになるか、設定によっては文字が欠けます。いったん ? として保存された文字は情報が失われているため、Mojibuster でも元に戻せません。

山田 のように化ける場合

UTF-8 の文章が latin1 の接続で latin1 の列に書き込まれると、アプリでは正しく見えても、phpMyAdmin やエクスポートでは 山田 のように表示されます。この場合はバイトが残っているので修正できます。

"1","山田太郎","大阪府","営業部"

"1","山田太郎","大阪府","営業部"

文字コードを確認する

• SHOW VARIABLES LIKE 'character_set%'; で、サーバーと接続の設定がわかります。
• SHOW CREATE TABLE customers; で、テーブルと列の文字コードがわかります。
• SELECT name, HEX(name) FROM customers LIMIT 5; で実際のバイトを確認できます。utf8mb4 の列で E5B1B1 なら正しい「山」、C3A5C2B1C2B1 ならすでに化けた å±± です。

エクスポートやダンプを修正する

1. phpMyAdmin でテーブルを SQL または CSV で書き出すか、mysqldump --default-character-set=utf8mb4 を使います。
2. 上の枠にファイルをドロップします。Mojibuster は化けた箇所だけを直し、正しい文字には手を加えません。
3. 変更箇所 で修正内容を確認し、ファイルをダウンロードします。
4. utf8mb4 のテーブルに取り込み、インポート画面の文字セットは utf-8 を選びます。
5. 本番のテーブルを置き換える前に、まずコピーで試してください。

ダンプはブラウザーの外に出ないので、顧客データを含むファイルでも安心して扱えます。書き出した CSV を Excel で開くと化ける場合は、Excel の CSV 文字化け を参照してください。

原因を直す

• 新しいテーブルは DEFAULT CHARSET=utf8mb4 で作ります。
• アプリの接続も utf8mb4 にします。PHP なら PDO の DSN に charset=utf8mb4 を付けます。
• latin1 の列に UTF-8 のバイトが入っている場合、CONVERT TO で直接変換してはいけません。もう一度エンコードされ、二重に化けます。安全なのはバイナリ型を経由する方法です。まず MODIFY name VARBINARY(255)、次に MODIFY name VARCHAR(255) CHARACTER SET utf8mb4 を実行します。
• sjis や ujis の列に日本語が正しく入っている場合は、ALTER TABLE customers CONVERT TO CHARACTER SET utf8mb4 でそのまま変換できます。

よくある質問

関連ガイド

• 文字化け修正ツール テキストやファイルの文字化けを直します。
• Excel の CSV 文字化け Excel で開いた CSV が文字化けするとき。
• 字幕の文字化け SRT・VTT・ASS 字幕の文字化けを直します。
• 文字化けとは 文字化けの意味・原因・よくあるパターンを解説します。
• PowerShell の文字化け 5.1 と 7 の -Encoding、コンソール、スクリプトファイル。
• pandas の文字化け read_csv・to_csv・open() の encoding 指定。
• Notepad++ の文字化け 文字コードの「選択」と「変換」の違い。
• Shift_JIS → UTF-8 古い日本語ファイルを UTF-8 に変換します。