データベースの文字化けを直す：どこでずれたのかを特定する

レン

サーバーを移したら、日本語が全部おかしな記号になってる…！

プロクラ

文字化けは、どこか1か所の指定がずれると起きる。しかも関わる場所が多いから、当てずっぽうで直そうとすると余計にこじれるんだ。順に切り分けよう。

関わる場所は4つ

文字の扱いは、データベース本体、テーブル、接続、そしてアプリの4か所で指定されます。どれか1つがずれていれば化けます。しかも書き込むときと読み出すときで別の場所がずれていることもあり、片方だけ直すと別の形で化けます。全部を揃えるのが唯一の解決です。

• データベース・テーブル・列に設定された文字コード
• アプリがデータベースへ接続するときに指定する文字コード
• アプリ自身が扱う文字コード
• ブラウザへ送るときに宣言する文字コード

プロクラ

この4つが揃っていれば化けない。逆に、どれか1つでもずれていると化ける。だから「どこがずれているか」を突き止めるのが仕事になる。

切り分ける

プロクラ

画面で化けているとき、まずデータベースの中身が正しいのかを確かめよう。ここが正しいかどうかで、原因の範囲が半分になる。

• コマンドで直接データベースに接続し、中身を表示してみる
• そこで正しく読める → 保存は正常。取り出しか表示の問題
• そこでも化けている → 保存の時点でずれている。より深刻
• 接続時に文字コードを指定してから確認すると、より確実

プロクラ

保存の時点で化けている場合、元の文字は失われていることがある。だからこそ、移行のときは事前の控えが重要なんだ。

移行で化けさせない手順

プロクラ

移行時の文字化けは、書き出しと取り込みで指定が食い違うのが原因。ここを揃えれば、ほとんど防げるよ。

• 書き出すとき、文字コードを明示して指定する
• 取り込むとき、同じ文字コードを明示して指定する
• 取り込み先のデータベースの設定も、同じにしておく
• 作業の前に、化けていない状態の控えを別に取っておく

プロクラ

4つめが保険になる。化けた状態で上書きしてしまうと戻せないので、元のファイルは必ず別に残しておこう。

絵文字が入らない場合

プロクラ

文字化けとは少し違うけれど、絵文字だけが保存できない、という症状もある。古い設定のまま作られたデータベースだと、絵文字を扱えない文字コードになっていることがあるんだ。

• 投稿に絵文字を含めるとエラーになる、または途中で切れる
• 対応する文字コードへ変更する必要がある
• 変更はテーブルと列の両方に対して行う
• 変更前に必ず控えを取る

レン

まずデータベースの中身が正しいかを見る。そこで範囲が半分になるんだね。

「?」や「□」に化けている場合

プロクラ

化け方でも原因の見当がつくよ。読めない記号が並ぶ場合と、すべてが同じ記号に潰れている場合では、起きたことが違う。

• 読めない文字が並ぶ → 別の文字コードとして解釈されている。元の情報は残っている可能性がある
• すべてが「?」に潰れている → 保存の時点で失われている。戻せないことが多い
• 一部の文字だけ化ける → 扱える文字の範囲が足りていない（絵文字など）
• 表示だけ化けて、別の画面では正しい → 宣言している文字コードの問題

プロクラ

2つめになってしまうと、控えが無い限り復元できない。だから移行前の控えは、化ける前に取ることが決定的に重要なんだ。