You need to enable JavaScript to run this app. 使用Python mysql.connector向MariaDB插入Emoji被替换为问号的问题
优惠活动
大模型
产品
解决方案
定价
更多

使用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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.27 09:15:10