解决 Python 2.7 查询 MySQL 时中文乱码的完整配置指南

乱码成因与解决思路

Python 2.7 默认使用 ASCII 编码处理字符串，而传统 MySQL 实例往往采用拉丁文（latin1）作为默认字符集。当两者未在连接层显式指定 UTF-8 时，数据在传输或落盘环节会发生编码转换冲突。此外，游标返回的原始字节流若未进行显式解码，直接打印也会导致显示异常。解决该问题的核心在于建立从操作系统、数据库服务到 Python 运行时的全链路 UTF-8 匹配。

第一步：修改 MySQL 配置文件

目的：将数据库服务的默认读写字符集永久改为 UTF-8，避免新表自动继承不兼容的旧编码。

入口：Linux 终端管理界面。

动作：执行 sudo vim /etc/mysql/my.cnf 打开配置文件，在对应分组下补充如下参数行。操作前建议先备份原文件以防误改。

[client]
default-character-set = utf8

[mysqld]
character-set-server = utf8
collation-server = utf8_general_ci

重要参数：character-set-server=utf8 与 collation-server=utf8_general_ci。

完成状态：保存并退出编辑器后，执行 sudo service mysql restart 重启服务。登录 MySQL 后输入 SHOW VARIABLES LIKE 'character%';，确认 Server 变量列均显示为 utf8。

第二步：连接数据库时显式声明字符集

目的：强制建立通信通道时使用 UTF-8，防止中间件或旧版驱动拦截并转换数据。

入口：Python 脚本初始化模块。

动作：在创建数据库连接对象时，追加 charset='utf8' 参数覆盖全局默认值。

import MySQLdb

db = MySQLdb.connect(
    user='your_user',
    passwd='your_password',
    host='localhost',
    db='your_database',
    charset='utf8'
)
cursor = db.cursor()

重要参数：charset='utf8'。

完成状态：调用 db.character_set_name() 返回值严格等于 'utf8'，且后续 SQL 执行不再报字符集警告。

第三步：调整 Python 运行时默认编码

目的：消除 Python 2.7 内部对字符串常量及标准库日志输出的 ASCII 限制，使框架底层能正确识别多字节中文字符。

入口：脚本顶层作用域（必须在导入其他模块前执行）。

动作：利用 sys 模块重新加载机制覆盖内置默认编码。

# -*- coding: utf-8 -*-
import sys

if sys.version_info[0] == 2:
    reload(sys)
    sys.setdefaultencoding('utf-8')

重要参数：sys.setdefaultencoding('utf-8')。

完成状态：执行 sys.getdefaultencoding() 返回 'utf-8'，控制台打印中文字符串不再触发 UnicodeEncodeError。

第四步：查询结果集的标准解码

目的：将 fetchall() 返回的原始字节序列（bytes）安全转换为 Python 字符串对象，便于下游业务逻辑处理。

入口：数据获取与展示逻辑块。

动作：遍历游标结果元组，对中文字段显式调用 .decode('utf-8') 进行转码。

sql = "SELECT id, name FROM users WHERE status = 1"
cursor.execute(sql)
rows = cursor.fetchall()

for row in rows:
    chinese_text = row[1].decode('utf-8')
    print(chinese_text)

重要参数：.decode('utf-8')。

完成状态：终端输出无问号占位符（）或截断符号，且在不同终端模拟器中均可正确渲染原始汉字。

常见问题排错指南

• 部分历史表仍乱码：建表时未指定 DEFAULT CHARSET=utf8。使用 SHOW CREATE TABLE table_name; 核对后，执行 ALTER TABLE table_name CONVERT TO CHARACTER SET utf8 COLLATE utf8_general_ci; 修复结构。
• 报错 Incorrect string value：通常因存储了 Emoji 或生僻字触发三字节 UTF-8 上限。需将服务端、表及列定义同步升级至 utf8mb4，并修改连接参数中的 charset 值。
• 解码时报 UnicodeDecodeError：表明上游传入的并非预期 UTF-8 流。请逐层排查数据源导出工具、ETL 管道或网络传输协议栈，确保源端与末端编解码规则完全闭环。

以上就是 Python 2.7 查询 MySQL 时出现中文乱码的详细处理方案与全链路配置方法，更多关于数据库字符集管理与 Python 编码规范的资料请关注本站其它相关文章！