15%

全场主机优惠15%

测试技能,享折扣

使用代码:

Skills
开始使用
08.10.2024

utf8 vs utf8mb4 在 MySQL 中:完整技术指南

MySQL的utf8字符集名不副实——它并非真正的UTF-8实现。它仅使用1到3个字节对字符进行编码,这意味着它会静默丢弃或拒绝U+FFFF以上的任何Unicode码点,包括所有表情符号和相当一部分补充CJK字符。utf8mb4才是MySQL正确、完整的UTF-8实现,支持每个字符1到4个字节以及完整的Unicode范围。对于2010年后构建的任何生产数据库,utf8mb4是唯一合理的选择。

本指南详细说明了这一区别的重要性、原始utf8设计的缺陷所在、如何安全迁移,以及如何在服务器、数据库、表和连接级别正确配置MySQL。

核心问题:为什么MySQL的utf8在设计上存在缺陷

UTF-8编码标准(RFC 3629)定义了一种可变宽度方案,使用1到4个字节来表示每个有效的Unicode码点——超过110万个可能的字符。当MySQL在4.1版本中引入其`utf8`字符集时,该实现被有意限制为每个字符最多3个字节。这是一个刻意为之的工程捷径,而非疏忽。

当时,InnoDB行格式对索引键前缀施加了767字节的限制。支持4字节字符会缩短`VARCHAR`列的最大索引前缀长度,造成索引兼容性问题。3字节上限是一个务实的变通方案,却成为了长期的技术负担。

实际后果:补充多语言平面(SMP)中的任何Unicode码点——即U+10000及以上的码点——都无法存储在`utf8`列中。这包括:

  • 所有标准表情符号(U+1F600及以上)
  • 数学字母数字符号(U+1D400–U+1D7FF)
  • 音乐符号
  • 历史文字,如线形文字B、哥特文字和楔形文字
  • 补充CJK统一表意文字(U+20000–U+2A6DF)
  • 近期Unicode版本中新增的某些货币符号和技术运算符

当应用程序尝试将4字节字符插入`utf8`列时,MySQL要么返回`Incorrect string value`错误,要么在`sql_mode`较为宽松的情况下静默截断数据。静默截断可以说是更危险的结果——您的应用程序不会收到任何错误,但数据已经损坏。

utf8mb4:正确的实现

MySQL在5.5.3版本(2010年发布)中引入了utf8mb4,专门用于解决这一缺陷。`mb4`后缀代表”多字节,最多4个字节”。它是`utf8`的严格超集——在`utf8`中可表示的每个字符在`utf8mb4`中都能以相同方式表示。从`utf8`迁移到`utf8mb4`不会造成数据丢失。

utf8mb4直接映射到RFC 3629 UTF-8标准。它无限制地处理从U+0000到U+10FFFF的完整Unicode码空间。

utf8与utf8mb4:功能对比

功能utf8(MySQL)utf8mb4
每字符字节数1–31–4
Unicode覆盖范围仅BMP(U+0000–U+FFFF)完整(U+0000–U+10FFFF)
表情符号支持
补充CJK
符合RFC 3629
最大索引前缀(InnoDB,4KB页)767字节767字节(191个字符)
最大索引前缀(innodb_large_prefix)3072字节3072字节(768个字符)
与latin1相比的存储开销ASCII相同ASCII相同
推荐用于新项目
引入的MySQL版本4.15.5.3

utf8mb4中的排序规则选择

选择utf8mb4作为字符集只是决策的一半。排序规则决定了字符串的比较、排序和索引方式。错误的排序规则会导致难以调试的查询行为。

utf8mb4_unicode_ci

基于Unicode排序算法(UCA)。能正确处理特定语言的排序规则。由于比较逻辑更复杂,速度略慢于`utf8mb4_general_ci`,但在现代硬件上性能差异可以忽略不计。

utf8mb4_general_ci

一种未完全实现UCA的简化排序规则。在2010年代初的基准测试中速度更快,但在当前CPU上速度优势已无关紧要。它在某些边缘情况下处理不正确——例如,它将某些本不应等同的德语字符视为等同。不建议用于新项目。

utf8mb4_0900_ai_ci

适用于MySQL 8.0+。基于Unicode 9.0,采用不区分重音(`ai`)和不区分大小写(`ci`)的比较方式。这是MySQL 8.0及更高版本的推荐默认值。它比`utf8mb4_unicode_ci`更快且更准确。

utf8mb4_bin

二进制比较——区分大小写、区分重音、无特定语言规则。当您需要精确的字节级匹配时使用,例如密码哈希或区分大小写的标识符。

建议:在MySQL 8.0+上使用`utf8mb4_0900_ai_ci`。在MySQL 5.7及更早版本上使用`utf8mb4_unicode_ci`。

存储和索引影响

从utf8迁移到utf8mb4时,一个常见的顾虑是存储开销。实际上,影响微乎其微:

  • ASCII字符(U+0000–U+007F)在两种编码中仍然只占1个字节。
  • 大多数拉丁文、希腊文、西里尔文、阿拉伯文和希伯来文字符在两种编码中均占2个字节。
  • BMP中的CJK字符在两种编码中均占3个字节。
  • 只有补充字符(表情符号、补充CJK)需要4个字节——而这些字符在utf8中本来就无法表示。

真正的索引问题是旧配置上767字节的InnoDB索引前缀限制。对于utf8mb4,每字符最多4字节意味着191个字符的`VARCHAR`索引前缀会触及767字节上限。而使用`utf8`时,同样的上限允许255个字符。如果您有带全列索引的`VARCHAR(255)`列,迁移过程中可能会遇到`Specified key was too long`错误。

解决方案:

  • 启用`innodb_large_prefix = ON`(MySQL 5.6/5.7)将限制提高到3072字节。
  • 对受影响的表使用`ROW_FORMAT=DYNAMIC`或`ROW_FORMAT=COMPRESSED`。
  • 在MySQL 8.0中,`innodb_large_prefix`默认启用,该参数已被移除。
  • 缩短索引前缀:使用`INDEX (column(191))`而非`INDEX (column(255))`。

这是最常见的迁移失败点,也是基础指南中最常被忽略记录的问题。

如何将MySQL数据库从utf8迁移到utf8mb4

迁移过程简单明了,但需要精确操作。跳过任何一个层级——服务器、数据库、表或连接——都会导致您的应用程序静默回退到旧编码。

第一步:备份数据库

切勿在未经验证的备份情况下修改生产数据库的字符编码。

“`bash

mysqldump -u username -p –single-transaction –routines –triggers

database_name > database_backup_$(date +%F).sql

“`

`–single-transaction`标志确保对InnoDB表进行一致性快照而不加锁。在继续操作之前,将备份存储在与数据库服务器分离的位置。

第二步:更新MySQL服务器配置

根据您的发行版编辑`/etc/mysql/my.cnf`或`/etc/mysql/mysql.conf.d/mysqld.cnf`:

“`ini

[client]

default-character-set = utf8mb4

[mysql]

default-character-set = utf8mb4

[mysqld]

character-set-server = utf8mb4

collation-server = utf8mb4_unicode_ci

For MySQL 5.6/5.7 only — remove on MySQL 8.0

innodb_large_prefix = ON

innodb_file_format = Barracuda

innodb_file_per_table = ON

“`

重启MySQL:

“`bash

sudo systemctl restart mysql

“`

第三步:转换数据库

“`sql

ALTER DATABASE database_name

CHARACTER SET = utf8mb4

COLLATE = utf8mb4_unicode_ci;

“`

第四步:转换所有表

为每张表生成并执行`ALTER TABLE`语句。在大型数据库结构上手动执行容易出错。使用以下查询自动生成语句:

“`sql

SELECT CONCAT(

'ALTER TABLE `', TABLE_NAME, '` CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;'

)

FROM information_schema.TABLES

WHERE TABLE_SCHEMA = 'database_name'

AND TABLE_TYPE = 'BASE TABLE';

“`

执行每条生成的语句。`CONVERT TO CHARACTER SET`语法在单次操作中同时更改表默认值和所有现有字符列。

第五步:修复索引长度错误

如果遇到`Specified key was too long; max key length is 767 bytes`,请找出有问题的索引:

“`sql

— Change full-column index to prefix index

ALTER TABLE table_name DROP INDEX index_name;

ALTER TABLE table_name ADD INDEX index_name (column_name(191));

“`

对于WordPress数据库,`wp_options`表的`option_name`列和`wp_postmeta`表的`meta_key`列是此错误的常见来源。

第六步:验证转换结果

“`sql

— Check server-level variables

SHOW VARIABLES LIKE 'character_set%';

SHOW VARIABLES LIKE 'collation%';

— Check a specific table

SHOW CREATE TABLE table_nameG

— Check all columns in a database

SELECT TABLE_NAME, COLUMN_NAME, CHARACTER_SET_NAME, COLLATION_NAME

FROM information_schema.COLUMNS

WHERE TABLE_SCHEMA = 'database_name'

AND DATA_TYPE IN ('char', 'varchar', 'text', 'tinytext', 'mediumtext', 'longtext');

“`

每个`CHARACTER_SET_NAME`值都应显示为`utf8mb4`。

第七步:更新应用程序连接字符串

如果您的应用程序使用错误的字符集进行连接,服务器和数据库模式的编码设置将毫无意义。连接级别的编码会覆盖服务器默认值。

PHP(PDO):

“`php

$dsn = 'mysql:host=localhost;dbname=database_name;charset=utf8mb4';

$pdo = new PDO($dsn, $user, $pass, [

PDO::MYSQL_ATTR_INIT_COMMAND => "SET NAMES utf8mb4 COLLATE utf8mb4_unicode_ci"

]);

“`

PHP(MySQLi):

“`php

$mysqli = new mysqli('localhost', $user, $pass, $db);

$mysqli->set_charset('utf8mb4');

“`

Python(mysql-connector-python):

“`python

cnx = mysql.connector.connect(

host='localhost', user=user, password=pass,

database=db, charset='utf8mb4', collation='utf8mb4_unicode_ci'

)

“`

Node.js(mysql2):

“`javascript

const pool = mysql2.createPool({

host: 'localhost', user: user, password: pass,

database: db, charset: 'utf8mb4'

});

“`

未设置连接字符集是表情符号在所谓完整迁移后仍然无法插入的最常见原因。

WordPress特定注意事项

WordPress自4.2版本(2015年4月)起已将utf8mb4作为默认字符集。如果您在从未迁移过的旧数据库上运行WordPress,`wp-config.php`文件中可能仍包含:

“`php

define('DB_CHARSET', 'utf8');

“`

将其更改为:

“`php

define('DB_CHARSET', 'utf8mb4');

define('DB_COLLATE', 'utf8mb4_unicode_ci');

“`

WordPress还包含一个内置升级程序(`maybe_convert_table_to_utf8mb4()`),在核心更新期间运行。但是,此程序并不总能捕获每张表,特别是由插件创建的表。使用上述手动`ALTER TABLE`方法更为可靠。

在具有root访问权限的VPS托管环境中,您可以使用Shell脚本自动化整个过程,并将其安排为一次性定时任务,从而完全控制时间安排和日志记录。

性能注意事项

对于绝大多数工作负载,utf8mb4与utf8的性能影响可以忽略不计:

  • 读取查询:对于BMP字符,没有可测量的差异。补充字符需要额外一个字节的I/O,这会被缓冲池缓存所吸收。
  • 写入查询:对于ASCII和BMP内容完全相同。对于补充字符略有增加。
  • 索引操作:如果您在长`VARCHAR`列上有全列索引,最大前缀长度的减少(全宽索引从255个字符降至191个字符)可能会影响查询计划。请在迁移前后审查您的索引。
  • 内存:MySQL根据每个字符的最大字节数为字符串操作分配固定宽度的缓冲区。从utf8(最多3字节)切换到utf8mb4(最多4字节)会使字符串密集型操作的内存排序缓冲区和临时表的内存分配增加约33%。在内存充足的独立服务器上,这无关紧要。在内存受限的共享环境中,迁移后请监控`sort_buffer_size`和`tmp_table_size`。

utf8仍然可接受的情况

保留`utf8`有一小部分合理理由:

  • 严格的遗留兼容性:应用程序使用无法处理4字节字符的未维护ORM或数据库驱动程序。这是技术债务问题,而非无限期保留utf8的理由。
  • 只读归档数据库:如果数据库永远不会接收新写入,且现有数据不包含补充字符,迁移只会增加风险而没有任何收益。
  • 严格的存储限制:在极端边缘情况下——嵌入式系统或容量严重受限的环境——微小的存储差异可能有所影响。这不适用于任何标准Web托管场景。

在所有其他情况下,utf8mb4是正确的选择。utf8节省存储空间的说法在技术上仅对补充字符成立,而这些字符在utf8中本来就无法表示。您并没有在无法存储的数据上节省空间。

为MySQL utf8mb4选择合适的托管环境

正确的utf8mb4配置需要访问MySQL服务器配置文件(`my.cnf`)。这排除了大多数无法修改服务器级变量的共享托管环境。

要完全控制MySQL字符编码、排序规则、InnoDB设置和连接参数,您需要具有root访问权限的VPS托管方案或独立服务器。两者都能让您直接访问`/etc/mysql/my.cnf`,能够重启MySQL服务,并可自由配置影响utf8mb4迁移成功的`innodb_large_prefix`、`ROW_FORMAT`等参数。

如果您管理多个数据库或客户站点,带cPanel的VPS提供了数据库管理的图形界面,同时保留了字符集配置所需的底层服务器访问权限。对于偏好命令行灵活性和轻量级面板的团队,VPS控制面板提供了多种适合不同操作工作流程的替代方案。

对于还需要安全数据传输的项目,将数据库迁移与正确配置的SSL证书配合使用,可确保utf8mb4编码的数据在传输过程中受到保护,而不仅仅是静态保护。

技术决策清单

在任何utf8到utf8mb4迁移之前和之后使用此清单:

迁移前:

  • [ ] 已验证`mysqldump`备份且可恢复
  • [ ] 已确认MySQL版本(utf8mb4需要5.5.3+)
  • [ ] 已检查`innodb_large_prefix`状态(如在MySQL 5.6/5.7上则启用)
  • [ ] 已识别所有带全列索引的`VARCHAR(255)`列
  • [ ] 已审查并更新应用程序连接字符集代码
  • [ ] 已为生产数据库安排维护窗口

迁移后:

  • [ ] `SHOW VARIABLES LIKE 'character_set%'`在服务器级别显示`utf8mb4`
  • [ ] `SHOW CREATE TABLE`确认所有已转换表上为`utf8mb4`
  • [ ] `information_schema.COLUMNS`查询确认没有剩余的`utf8`列
  • [ ] 连接代码中已确认应用程序级别的`SET NAMES utf8mb4`或等效设置
  • [ ] 在代表性表上通过了表情符号插入测试
  • [ ] 查询性能基准与迁移前指标进行了比较
  • [ ] 已验证索引长度——长索引值无静默截断

常见问题

从utf8迁移到utf8mb4会导致数据丢失吗?

不会。utf8mb4是MySQL utf8的严格超集。存储在utf8列中的每个字符在utf8mb4中都能以相同方式表示。迁移对现有数据是无损的。唯一的风险是带全列索引的`VARCHAR(255)`列上的索引长度错误,必须通过缩短索引前缀来解决。

为什么将表转换为utf8mb4后表情符号仍然无法插入?

最常见的原因是应用程序连接字符集。如果您的PHP、Python或Node.js代码在连接时未明确指定`utf8mb4`,MySQL会将服务器的`character_set_client`默认值用于该会话。请在连接配置中添加`SET NAMES utf8mb4`或等效的字符集参数。

utf8mb4_unicode_ci和utf8mb4_0900_ai_ci有什么区别?

`utf8mb4_unicode_ci`基于Unicode 4.0排序规则,是MySQL 5.7的标准选择。`utf8mb4_0900_ai_ci`基于Unicode 9.0,是MySQL 8.0的默认值,速度更快且语言准确性更高。新项目在MySQL 8.0+上请使用`utf8mb4_0900_ai_ci`。

切换到utf8mb4会显著增加数据库存储大小吗?

实际上不会。ASCII和大多数BMP字符在两种编码中使用相同数量的字节。只有补充字符(表情符号、补充CJK)使用4个字节——而这些字符在utf8中本来就无法表示。字符串密集型操作的排序缓冲区内存开销增加约33%,但在任何现代服务器上这都可以忽略不计。

我可以在共享托管上配置utf8mb4吗?

部分可以。您可以使用SQL `ALTER`语句在数据库和表级别设置字符集,也可以在应用程序的连接字符串中指定字符集。但是,您无法在共享托管上修改`my.cnf`或重启MySQL。服务器级别的默认值将保持不变,这意味着通过托管面板创建的新数据库可能默认使用utf8。完整的utf8mb4配置需要具有root访问权限的VPS或独立服务器。

15%

全场主机优惠15%

测试技能,享折扣

使用代码:

Skills
开始使用