mysql utf8和utf8mb4不兼容问题

原创

mob649e815da088 2023-07-21 15:03:58 ©著作权

©著作权归作者所有：来自51CTO博客作者mob649e815da088的原创作品，请联系作者获取转载授权，否则将追究法律责任

MySQL UTF8和UTF8MB4不兼容问题

在使用MySQL数据库时，我们经常需要处理多语言字符集和表情符号等特殊字符。MySQL提供了不同的字符集支持，其中最常用的是UTF8和UTF8MB4。然而，这两个字符集在一些情况下存在兼容性问题，本文将详细介绍这个问题，并提供相应的解决方案。

问题描述

MySQL的UTF8字符集实际上只支持最多3个字节长度的字符，这导致它无法存储一些特殊字符，如四字节长度的表情符号。为了解决这个问题，MySQL引入了UTF8MB4字符集，它可以支持最多4个字节长度的字符。然而，由于历史原因，MySQL在默认情况下仍然将UTF8字符集配置为最多3个字节长度，这导致了UTF8MB4字符集与之不兼容。

具体来说，如果我们在将数据库或表格的字符集设置为UTF8MB4时，如果数据库或表格中包含UTF8字符集的列，则会出现以下错误：

ERROR 1071 (42000): Specified key was too long; max key length is 767 bytes

这个错误发生在创建或修改带有唯一索引的表格时，因为UTF8MB4字符集需要更多的字节来存储相同的字符串，从而超过了索引的最大长度限制。

解决方案

为了解决UTF8和UTF8MB4不兼容的问题，我们可以采取以下步骤：

1. 修改MySQL配置文件

首先，我们需要修改MySQL配置文件，将默认的字符集设置为UTF8MB4。在MySQL配置文件（通常是my.cnf或my.ini）中，找到以下部分：

[mysqld]
character-set-server=utf8

将character-set-server的值改为utf8mb4，并重新启动MySQL服务。

2. 修改现有数据库和表格

接下来，我们需要修改现有的数据库和表格，将字符集从UTF8更改为UTF8MB4。可以使用以下命令逐个修改数据库和表格的字符集：

ALTER DATABASE database_name CHARACTER SET = utf8mb4 COLLATE = utf8mb4_unicode_ci;
ALTER TABLE table_name CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

3. 修改连接字符集

最后，我们需要在连接数据库时将字符集设置为UTF8MB4。在使用MySQL连接库时，可以调用相应的方法来设置连接字符集。例如，使用Python的pymysql库连接数据库的示例代码如下：

import pymysql

conn = pymysql.connect(host='localhost',
                       user='root',
                       password='password',
                       database='database_name',
                       charset='utf8mb4')

在使用其他类型的MySQL连接库时，请查阅相应的文档了解如何设置连接字符集。