MySQLで日本語が文字化けする原因と対処法｜UTF8MB4で正しく扱う方法を徹底解説

1. はじめに

MySQLで日本語がうまく扱えない？その原因と解決策を徹底解説

2. 日本語が文字化けする主な原因

なぜMySQLで日本語が正しく表示されないのか？

原因1：デフォルトの文字コードが latin1 のまま

原因2：クライアントとサーバー間の文字コードの不一致

• クライアントからの送信時（character_set_client）
• サーバー側の処理時（character_set_server）
• 結果の出力時（character_set_results）

原因3：データベース・テーブル・カラムの設定がバラバラ

• データベースは utf8mb4 だが、
• テーブルは utf8、
• カラムは latin1 など、

まとめ：原因の多くは「文字コードの不一致」

3. MySQLの文字コード設定を確認する方法

トラブルの原因を突き止めるには「現在の設定確認」が第一歩

SHOW VARIABLES コマンドで文字コードをチェック

SHOW VARIABLES LIKE 'character_set%';

+--------------------------+---------+
| Variable_name            | Value   |
+--------------------------+---------+
| character_set_client     | utf8mb4 |
| character_set_connection | utf8mb4 |
| character_set_database   | utf8mb4 |
| character_set_results    | utf8mb4 |
| character_set_server     | utf8mb4 |
| character_set_system     | utf8    |
+--------------------------+---------+

各設定項目の意味

文字化け防止のためのチェックポイント

• すべての項目が utf8mb4 になっているか確認
• 異なる文字コードが混在している場合は、あとで紹介する設定変更を行う
• テーブルやカラム単位でも別途文字コードが指定されている場合があるので注意

補足：照合順序（collation）も確認しよう

SHOW VARIABLES LIKE 'collation%';

4. 日本語を正しく扱うための設定方法

正しい設定で「文字化け」とサヨナラ

4.1 クライアント側の設定：接続時に明示しよう

SET NAMES 'utf8mb4';

• character_set_client
• character_set_connection
• character_set_results

✅補足：

• PHPから接続する場合は mysqli_set_charset($conn, 'utf8mb4'); のように記述します。
• CLIで mysql コマンドを使うとき --default-character-set=utf8mb4 を指定するのも効果的です。

4.2 サーバー側の設定：my.cnf による永続設定

[client]
default-character-set = utf8mb4
[mysql]

default-character-set = utf8mb4
[mysqld]

character-set-server = utf8mb4 collation-server = utf8mb4_general_ci

✅注意点：

• 設定変更後はMySQLの再起動が必要です。
• 例：sudo systemctl restart mysql（Linux）
• ファイルの場所は環境によって異なり、Linuxでは /etc/mysql/my.cnf や /etc/my.cnf がよく使われます。

4.3 データベースとテーブルの文字コード指定

データベースの作成例：

CREATE DATABASE mydb CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;

テーブルの作成例：

CREATE TABLE users (
  id INT AUTO_INCREMENT PRIMARY KEY,
  name VARCHAR(100)
) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;

既存のテーブルを変更する場合：

ALTER TABLE users CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;

4.4 推奨する文字コード：なぜ utf8mb4 なのか？

5. Docker環境での日本語対応

コンテナ環境でも日本語を正しく扱うために

5.1 Dockerfileでロケール（言語環境）を日本語対応に設定

RUN apt-get update && apt-get install -y locales   && locale-gen ja_JP.UTF-8   && update-locale LANG=ja_JP.UTF-8
ENV LANG=ja_JP.UTF-8
ENV LC_ALL=ja_JP.UTF-8

✅ポイント：

• アプリケーション側で日本語ファイルを読み書きする際のエンコーディングエラーを防げます。
• MySQL単体ではなく、PHPやPythonなどの実行環境にも影響します。

5.2 docker-composeでMySQLに文字コードを指定する方法

services:
  db:
    image: mysql:8.0
    container_name: mysql-ja
    environment:
      MYSQL_ROOT_PASSWORD: rootpass
      MYSQL_DATABASE: mydb
      MYSQL_USER: user
      MYSQL_PASSWORD: password
      TZ: Asia/Tokyo
      LANG: ja_JP.UTF-8
      LC_ALL: ja_JP.UTF-8
    command:
      --character-set-server=utf8mb4 --collation-server=utf8mb4_general_ci
    ports:
      - "3306:3306"
    volumes:
      - ./mysql-data:/var/lib/mysql

✅補足：

• command: セクションでMySQL起動時のパラメータを設定できます。
• TZ や LANG も日本語環境を整える上で有効です。

5.3 MySQLコンテナ内での日本語の動作確認

docker exec -it mysql-ja mysql -u root -p

SHOW VARIABLES LIKE 'character_set%';

まとめ：Docker環境では「起動時設定」と「ロケール」が鍵

• MySQLコンテナの起動時に utf8mb4 を明示
• アプリ側コンテナのロケールを ja_JP.UTF-8 に設定

6. よくあるトラブルとその対処法

設定したのに文字化け…？まだ原因は残っているかもしれません

トラブル1：設定変更が反映されない

• サーバー環境なら sudo systemctl restart mysql で再起動
• Dockerなら docker-compose down → docker-compose up -d を実行

トラブル2：ターミナルやコマンドライン上で日本語が文字化け

• Windowsの場合：chcp 65001 コマンドでUTF-8に切り替える
• macOS/Linuxの場合：ターミナルのエンコーディングをUTF-8に設定（多くはデフォルトで対応）

トラブル3：既存のデータベースやテーブルが latin1 で作られていた

1. テーブル構造を確認：

   SHOW CREATE TABLE your_table_name;

2. テーブルを変換：

   ALTER TABLE your_table_name CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;

トラブル4：PHPやPythonなどアプリケーション側での文字コード不一致

• PHP：mysqli_set_charset($conn, "utf8mb4");
• Python（MySQL Connector）：charset='utf8mb4' を接続時に指定

トラブル5：CSVやExcelとの連携時に文字化けする

• CSVを読み込む前に文字コードをUTF-8に変換
• エクスポート時は SET NAMES 'utf8mb4'; を明示
• Excelに読み込むときは「UTF-8（BOM付き）」で保存

トラブル解消のための総合チェックリスト

7. まとめ

MySQLで日本語を扱うために必要な設定と考え方を再確認

本記事で解説した主要ポイントのおさらい：

• 日本語が文字化けする主な原因は、latin1 など不適切な文字コードの使用、またはクライアント・サーバー間の設定不一致。
• MySQLの文字コード設定は SHOW VARIABLES コマンドで確認可能。
• 推奨文字コードは utf8mb4。これはUTF-8の完全版であり、絵文字や漢字の異体字にも対応。
• 設定は3段階で行うことが望ましい：クライアント、サーバー、データベース・テーブル単位。
• Docker環境では command: や LANG の指定が必須。ロケールと文字コードの両方を調整する必要がある。
• トラブルが発生した場合は段階的に原因を切り分けて対処。MySQL本体だけでなく、ターミナル・アプリケーション・外部データとのやり取りも確認ポイント。

今後の運用で意識したいポイント

• 新しくMySQL環境を構築する際は、初期段階で utf8mb4 を前提とした設計をする。
• チームや複数環境で開発を行う場合は、設定ファイルや接続パラメータを明文化・共有する。
• DockerやCI/CD環境では、設定の自動化（環境変数や設定ファイル管理）が鍵になります。
• データのインポート・エクスポート時には、文字コード変換ツール（iconvやnkfなど）の活用も検討を。

最後に

8. よくある質問（FAQ）

MySQLと日本語に関する、よくある疑問を解決します

Q1. MySQLで日本語が「???」と表示されてしまいます。原因は何ですか？

Q2. my.cnf に utf8mb4 を設定したのに、反映されません。

Q3. 既存のテーブルで日本語が文字化けしています。修正できますか？

1. テーブル構造を確認（SHOW CREATE TABLE）
2. 文字コードを変換

   ALTER TABLE your_table_name CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;

Q4. DockerでMySQLを使っていますが、日本語入力で文字化けします。

Q5. utf8 と utf8mb4 はどう違うのですか？どちらを使うべき？

Q6. ExcelでエクスポートしたCSVが文字化けします。どうすれば？