Python连接MySQL查询结果乱码的参数配置方法-mysql教程-PHP中文网

Python连接MySQL查询结果乱码的参数配置方法

穿越時空

发布： 2025-06-27 15:12:02

原创

909人浏览过

python连接mysql查询结果出现乱码的解决方法是确保字符集设置一致。1. 确保数据库和表使用utf8mb4字符集，可通过show create database和show create table检查并用alter语句修改；2. python连接时在参数中指定charset='utf8mb4'；3. 检查并设置连接的校验规则，执行set names和set character set为utf8mb4；4. 确保终端或输出环境支持utf-8编码。按照以上步骤操作即可避免乱码问题。

Python连接MySQL查询结果乱码的参数配置方法

Python连接MySQL查询结果出现乱码，通常是因为字符集设置不一致。要解决这个问题，关键在于正确配置数据库连接参数中的charset选项，确保从数据库到程序之间的字符传输是一致的。

1. 确保MySQL数据库和表使用正确的字符集

在开始写代码之前，先检查一下你的数据库、表以及字段的字符集设置是否统一。推荐使用utf8mb4，它支持更广泛的字符（包括表情符号）：

数据库字符集：

立即学习“Python免费学习笔记（深入）”；
```
SHOW CREATE DATABASE your_db;
```
登录后复制
应该看到 CHARACTER SET utf8mb4
表字符集：
```
SHOW CREATE TABLE your_table;
```
登录后复制
同样应为 CHARACTER SET utf8mb4

如果发现不是，可以用以下语句修改：

ALTER DATABASE your_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE your_table CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

登录后复制

2. Python连接时指定charset='utf8mb4'

在用pymysql或mysql-connector-python等库连接MySQL时，一定要在连接参数中显式指定charset='utf8mb4'，否则默认可能使用的是latin1或者其他编码。

示例（以pymysql为例）：

import pymysql

conn = pymysql.connect(
    host='localhost',
    user='root',
    password='your_password',
    database='your_db',
    charset='utf8mb4',  # 关键点在这里
    cursorclass=pymysql.cursors.DictCursor
)

登录后复制

如果你漏掉了这一步，即使数据库是utf8mb4，Python读出来的数据也可能显示乱码，尤其是中文或表情符号。

3. 检查连接的校验规则（Collation）

有时候虽然设置了charset='utf8mb4'，但仍然有问题，可能是服务器端默认的collation设置不对。可以在连接后执行一句SQL查看当前连接的字符集配置：

SHOW VARIABLES LIKE 'character_set%';

登录后复制

你应该看到类似下面的结果：

character_set_client    | utf8mb4
character_set_connection| utf8mb4
character_set_database  | utf8mb4
character_set_results   | utf8mb4
character_set_server    | utf8mb4

登录后复制

如果不是，可以在连接成功后主动执行：

cursor.execute("SET NAMES 'utf8mb4'")
cursor.execute("SET CHARACTER SET utf8mb4")

登录后复制

4. 确保终端/输出环境也支持UTF-8

最后别忘了，打印或者展示的时候也要保证输出环境支持UTF-8，比如你在命令行运行脚本，确保终端编码是UTF-8；如果是网页展示，也要设置HTML的meta头或响应头为UTF-8。

基本上就这些。只要数据库、连接参数和输出环境三者都使用UTF-8或utf8mb4，Python连接MySQL就不会再出现乱码问题了。

以上就是Python连接MySQL查询结果乱码的参数配置方法的详细内容，更多请关注php中文网其它相关文章！