使用Python mysql.connector向MariaDB插入Emoji被替换为问号的问题
问题成因
该问题的根因与Python端编码逻辑、数据库本身的全局/库表字符集配置均无关,核心出在mysql.connector与MariaDB的连接通道字符集匹配环节。
mysql.connector多数稳定版本的默认连接配置会将通道字符集降级为旧版3字节utf8(该字符集仅支持BMP基本多文种平面内的字符,无法承载4字节长度的Emoji字符)。此时即便库表本身配置为utf8mb4、通过phpMyAdmin可以正常写入Emoji,4字节的Emoji数据在经过仅支持3字节编码的连接通道时,会被识别为无法正常编码的无效字符,最终被自动替换为问号。
修复方案
- 建立数据库连接时,在初始化参数中显式指定连接层使用utf8mb4编码,覆盖默认的降级配置。示例代码如下:
import mysql.connector db_conn = mysql.connector.connect( host="你的数据库服务地址", user="你的数据库账号", password="你的数据库密码", database="目标操作库名", charset="utf8mb4", collation="utf8mb4_general_ci" )
- 如果不方便修改连接初始化参数,可在连接建立完成后,立即执行两条连接级编码修正命令,实现同等效果:
db_cursor = db_conn.cursor() # 强制当前连接的客户端、传输通道、返回结果全部使用utf8mb4编码 db_cursor.execute("SET NAMES utf8mb4 COLLATE utf8mb4_general_ci;") db_cursor.execute("SET CHARACTER SET utf8mb4;")
- 配置完成后可执行验证命令确认生效:
db_cursor.execute("SHOW VARIABLES LIKE 'character_set%';") print(db_cursor.fetchall())
确认返回结果中character_set_client、character_set_connection、character_set_results三个变量的值全部为utf8mb4,即代表连接通道的编码配置已正常,此时再插入包含Emoji的Steam用户昵称就不会出现字符被替换为问号的问题。
补充踩坑提示:连接通道的字符集配置是独立于库表字符集的独立配置项,不会自动跟随库表的utf8mb4配置同步更新,这也是很多人完成库表字符集调整后,通过应用写入Emoji仍然异常的核心原因。
内容的提问来源于stack exchange,提问作者JonaWe
相关产品推荐
相关产品推荐

