PyMySQL 常见问题解决方案-CSDN博客

本文链接：https://blog.csdn.net/gitblog_09347/article/details/142231275

PyMySQL 常见问题解决方案

PyMySQL PyMySQL/PyMySQL: 是一个用于 Python 程序的 MySQL 数据库连接库，它实现了 MySQL 数据库的 Python API。适合用于使用 Python 开发的应用程序连接和操作 MySQL 数据库。特点是官方支持、易于使用、支持多种 MySQL 功能。项目地址: https://gitcode.com/gh_mirrors/py/PyMySQL

项目基础介绍

PyMySQL 是一个纯 Python 编写的 MySQL 客户端库，基于 PEP 249 规范。它允许 Python 开发者通过 Python 代码与 MySQL 数据库进行交互。PyMySQL 支持 Python 3.7 及以上版本，并且兼容 MySQL 5.7 及以上版本或 MariaDB 10.4 及以上版本。

新手使用注意事项及解决方案

1. 安装 PyMySQL 时依赖缺失

问题描述：在安装 PyMySQL 时，可能会遇到依赖缺失的问题，尤其是在使用某些高级认证方法（如 sha256_password 或 caching_sha2_password）时。

解决步骤：

安装 PyMySQL 基础包：
```
python3 -m pip install PyMySQL
```
安装额外依赖：
- 如果需要使用 sha256_password 或 caching_sha2_password 认证方法，安装 PyMySQL[rsa]：
```
python3 -m pip install PyMySQL[rsa]
```
- 如果需要使用 MariaDB 的 ed25519 认证方法，安装 PyMySQL[ed25519]：
```
python3 -m pip install PyMySQL[ed25519]
```

2. 数据库连接失败

问题描述：在尝试连接 MySQL 数据库时，可能会遇到连接失败的问题，通常是由于配置错误或数据库服务未启动。

解决步骤：

检查数据库配置：

确保数据库主机地址、用户名、密码和数据库名称正确。

示例连接代码：

import pymysql.cursors

connection = pymysql.connect(
    host='localhost',
    user='user',
    password='passwd',
    database='db',
    cursorclass=pymysql.cursors.DictCursor
)

检查数据库服务状态：
- 确保 MySQL 或 MariaDB 服务正在运行。可以通过命令行或数据库管理工具检查服务状态。

3. 数据插入或查询时出现编码问题

问题描述：在插入或查询数据时，可能会遇到字符编码问题，导致数据乱码或插入失败。

解决步骤：

设置数据库连接编码：

在连接数据库时，显式设置字符集为 utf8mb4，以支持完整的 Unicode 字符集。

示例连接代码：

connection = pymysql.connect(
    host='localhost',
    user='user',
    password='passwd',
    database='db',
    charset='utf8mb4',
    cursorclass=pymysql.cursors.DictCursor
)

确保数据库表的编码设置：
- 确保数据库表和字段的编码设置为 utf8mb4。可以通过 SQL 命令检查和修改表的编码设置。
- 示例 SQL 命令：
```
ALTER TABLE `users` CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
```