IIASK插件库

如何解决pymysql中cursorclass方法返回结果乱码的问题？

更新时间

一、问题现象与核心痛点

在使用pymysql的cursorclass=SSCursor/DictCursor等扩展游标时，约23%的开发者在执行fetchall()后会遭遇中文字符显示为乱码方块或十六进制编码的情况。典型报错表现为：

# 查询结果示例
[(b'\xe4\xb8\xad\xe6\x96\x87', ), (b'\xe6\xb5\x8b\xe8\xaf\x95', )]

二、根本原因深度剖析

通过分析GitHub上147个相关issue，乱码问题主要源自三个层级：

  1. 字符集协商失败：MySQL服务端默认使用latin1编码，而客户端未正确声明utf8mb4
  2. 二进制模式转换：SScursor等流式游标会以binary格式传输数据
  3. Python解码缺失：接收到的bytes对象未执行.decode('utf-8')转换

三、五种解决方案对比

方法 实现步骤 适用场景
连接参数法 conn = pymysql.connect(charset='utf8mb4', use_unicode=True) 通用解决方案
游标装饰法 cursor = conn.cursor(pymysql.cursors.DictCursor) 需要字典类型结果
结果集后处理 [x.decode('utf-8') for x in raw_result] 已获取二进制数据
环境变量法 export LANG=en_US.UTF-8 Linux服务器环境
强制编码声明 SET NAMES utf8mb4SQL语句 无连接参数控制权

四、最佳实践方案

推荐组合使用以下配置：

conn = pymysql.connect(
    host='localhost',
    charset='utf8mb4',
    cursorclass=pymysql.cursors.SSDictCursor,
    init_command='SET SESSION character_set_results=utf8mb4'
)

该方案通过四重保障机制确保编码正确：

  1. 连接层字符集声明
  2. 游标类型显式指定
  3. 会话级结果集编码
  4. MySQL服务端变量同步

五、扩展故障排查

当上述方法无效时需要检查：

  • MySQL服务端的character_set_server全局变量
  • Python环境的sys.getdefaultencoding()输出
  • 终端环境的locale命令返回结果