萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 資料庫 >> MySQL 教學

MySQL "Incorrect string value" 錯誤解決:utf8mb4 字符集完整配置指南

錯誤現場

ERROR 1366 (HY000) at line 907: 
Incorrect string value: '\xF0\x9F\x9B\xB3, ...' for column 'option_value' at row 1

十六進制 \xF0\x9F\x9B\xB3 對應 Emoji 🛳(4 字節 UTF-8)。

根因分析

  • 表/庫字符集為 utf8mb4(支持 4 字節),但連接層字符集未同步。
  • 客戶端/連接仍用 utf8(僅 3 字節),導致 4 字節字符截斷報錯。

完整修復方案:全鏈路 utf8mb4

1. 服務端配置 /etc/my.cnf

[client]
default-character-set=utf8mb4

[mysql]
default-character-set=utf8mb4

[mysqld]
character-set-server=utf8mb4
collation-server=utf8mb4_general_ci
init_connect='SET NAMES utf8mb4'  # 非超級用戶自動執行
skip-character-set-client-handshake  # 強制忽略客戶端請求字符集

2. 修改現有庫表字符集

-- 庫級
ALTER DATABASE db_name CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;

-- 表級(含所有字段)
ALTER TABLE tbl_name CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;

-- 單字段
ALTER TABLE tbl_name MODIFY col_name VARCHAR(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;

3. 應用層連接字符串

JDBC:jdbc:mysql://host:3306/db?characterEncoding=utf8mb4&useUnicode=true

PHP PDO:charset=utf8mb4 in DSN

Python PyMySQL:charset='utf8mb4'

Go sqlx:db.SetConnMaxLifetime... 連接參數 charset=utf8mb4


驗證檢查清單

SHOW VARIABLES LIKE 'character_set_%';
SHOW VARIABLES LIKE 'collation_%';
-- 關鍵項均應為 utf8mb4

避坑指南

  • utf8 ≠ utf8mb4:MySQL 歷史包袱,utf8 實為 utf8mb3(最多 3 字節)。
  • utf8mb4_general_ci vs utf8mb4_unicode_ci:前者速度快但排序不完全符合 Unicode;後者精準但稍慢。一般業務推薦 utf8mb4_general_ci。
  • 索引長度限制:utf8mb4 單字符 4 字節,VARCHAR(255) 索引需 1020 字節,InnoDB 單索引限制 767 字節(innodb_large_prefix=ON + ROW_FORMAT=DYNAMIC 可放寬至 3072 字節)。
  • 備份/恢復工具(mysqldump、xtrabackup)需同步指定 --default-character-set=utf8mb4。
copyright © 萬盛學電腦網 all rights reserved