python中怎么连接MySQL数据库_Python使用PyMySQL连接MySQL数据库教程

裘德小鎮的故事

发布时间：2025-09-18 19:27:01

497人浏览过

来源于php中文网

原创

答案：使用PyMySQL连接MySQL是Python中最常用且推荐的方式，因其纯Python实现、兼容性好、安装简便且支持DB-API 2.0规范。通过pymysql.connect()建立连接，配合参数化查询防止SQL注入，使用DictCursor获取字典结果，并在异常处理中确保连接关闭。实际项目中应采用连接池提升性能，避免频繁创建连接；敏感信息需通过环境变量管理，不硬编码；字符集设为utf8mb4以支持中文和Emoji；常见问题如连接拒绝、权限错误、数据库不存在等可通过检查服务状态、网络连通性、用户权限及日志逐步排查。

python中怎么连接mysql数据库_python使用pymysql连接mysql数据库教程

Python连接MySQL数据库，最常用且推荐的方式就是通过第三方库PyMySQL。它提供了一套符合Python DB-API 2.0规范的接口，让开发者可以像操作其他数据库一样，方便地与MySQL进行交互，包括建立连接、执行SQL查询、插入、更新数据以及获取结果集。本质上，PyMySQL扮演了一个翻译官的角色，将Python代码的指令转换为MySQL服务器能理解的协议，再将服务器的响应传回给Python。

解决方案

使用PyMySQL连接MySQL数据库的核心流程相对直接。首先需要安装PyMySQL库，通常通过

pip install PyMySQL

完成。之后，代码层面主要是导入库、建立连接、创建游标、执行SQL、提交事务（如果需要）以及关闭连接和游标。

一个典型的连接和查询示例大概是这样的：

import pymysql

# 数据库连接参数，通常建议从配置文件或环境变量中读取，避免硬编码
DB_HOST = 'localhost'
DB_USER = 'your_username'
DB_PASSWORD = 'your_password'
DB_NAME = 'your_database'
DB_PORT = 3306 # MySQL默认端口

connection = None # 初始化连接变量
try:
    # 建立数据库连接
    connection = pymysql.connect(
        host=DB_HOST,
        user=DB_USER,
        password=DB_PASSWORD,
        database=DB_NAME,
        port=DB_PORT,
        charset='utf8mb4', # 确保字符集正确处理中文或特殊字符
        cursorclass=pymysql.cursors.DictCursor # 返回字典类型结果，方便按字段名访问
    )

    # 创建一个游标对象，用于执行SQL命令
    # 默认是TupleCursor，这里使用了DictCursor
    with connection.cursor() as cursor:
        # 执行一个简单的查询
        sql_query = "SELECT id, name, email FROM users WHERE status = %s"
        cursor.execute(sql_query, ('active',)) # 参数化查询，防止SQL注入

        # 获取所有查询结果
        results = cursor.fetchall()
        print("查询结果:")
        for row in results:
            print(f"ID: {row['id']}, Name: {row['name']}, Email: {row['email']}")

        # 也可以执行插入、更新、删除等操作
        # insert_sql = "INSERT INTO products (name, price) VALUES (%s, %s)"
        # cursor.execute(insert_sql, ('New Product', 99.99))
        # connection.commit() # 提交事务，确保更改生效
        # print(f"插入了 {cursor.rowcount} 条数据")

except pymysql.Error as e:
    print(f"数据库操作失败: {e}")
    # 可以根据错误类型进行更细致的处理，比如重试或记录日志
finally:
    # 无论如何，确保关闭数据库连接
    if connection:
        connection.close()
        print("数据库连接已关闭。")

这段代码展示了从连接到查询、结果处理的完整流程。关键在于

pymysql.connect()

方法中的参数配置，特别是

charset

和

cursorclass

，它们对数据处理和结果返回格式至关重要。

立即学习“Python免费学习笔记（深入）”；

PyMySQL相比其他Python MySQL库有什么优势？

在Python生态中，连接MySQL的库并不少，比如官方的

mysql-connector-python

、老牌的

MySQLdb

等。我个人在多数项目中更倾向于选择PyMySQL，主要有以下几个考量：

首先，纯Python实现是PyMySQL的一大亮点。这意味着它不需要编译C扩展，安装过程通常更为顺畅，尤其是在一些没有C编译器或者编译环境配置复杂的系统上，这能省去不少麻烦。相比之下，

MySQLdb

就需要依赖

mysqlclient

，而

mysqlclient

在安装时可能需要系统安装MySQL开发库。

其次，兼容性好。PyMySQL同时支持Python 2和Python 3，尽管现在Python 2已经不推荐使用，但对于一些遗留项目来说，这种兼容性仍然有价值。更重要的是，它严格遵循Python DB-API 2.0规范，这意味着如果你熟悉这个API，切换到PyMySQL几乎没有学习成本，代码的可移植性也更强。

Amazon Nova

亚马逊云科技（AWS）推出的一系列生成式AI基础模型

下载

再者，活跃的社区支持和维护。一个库的生命力很大程度上取决于其社区活跃度。PyMySQL在这方面做得不错，遇到问题时，通常能在GitHub或Stack Overflow上找到解决方案或讨论。

mysql-connector-python

作为官方库，虽然功能全面，但有时感觉有点“重”，而PyMySQL则显得更轻量、更灵活。

当然，选择哪个库最终还是取决于项目具体需求和个人偏好。但就我经验来看，对于大多数常规的Web应用或数据处理任务，PyMySQL通常是一个开箱即用、表现可靠的优秀选择。

在实际项目中，如何更安全、高效地管理数据库连接？

实际项目中的数据库连接管理，远不止简单地

connect()

和

close()

。这涉及到安全性、性能和资源利用率等多个方面，做得好坏直接影响应用的稳定性和扩展性。

1. 连接池（Connection Pooling）是性能基石。 频繁地建立和关闭数据库连接是非常耗费资源的。每次建立连接都需要进行网络握手、身份验证等操作，这会显著增加请求延迟。连接池的作用就是预先创建一定数量的数据库连接，并将它们放入一个池子中。当应用需要连接时，直接从池中获取一个可用的连接；使用完毕后，将连接归还给池，而不是真正关闭。这样就大大减少了连接创建和销毁的开销。在Python中，可以考虑使用

DBUtils

这样的库，或者自己实现一个简单的连接池管理类。没有连接池，高并发场景下你的应用很快就会因为数据库连接耗尽或响应缓慢而崩溃。

2. 参数化查询（Parameterized Queries）是安全底线。 SQL注入是数据库安全中最常见的威胁之一。永远不要直接将用户输入拼接到SQL语句中！PyMySQL和其他DB-API 2.0兼容的库都支持参数化查询。例如，

cursor.execute("SELECT * FROM users WHERE username = %s", (username_from_input,))

。PyMySQL会自动处理参数的转义，有效防止恶意代码的注入。这是必须遵循的实践，没有之一。

3. 严谨的错误处理和资源释放。 数据库操作总会遇到各种异常，比如网络中断、数据库宕机、SQL语法错误等。使用

try...except...finally

结构来捕获异常，并在

finally

块中确保连接和游标被正确关闭，即使发生错误也要释放资源，避免连接泄露。连接泄露会导致连接池耗尽，最终使应用无法再连接数据库。

4. 敏感信息（如数据库凭据）的安全管理。 数据库的用户名、密码等敏感信息绝不能硬编码在代码中，也不能直接提交到版本控制系统。最佳实践是使用环境变量、配置文件（且配置文件本身不应公开）或专门的密钥管理服务来存储和获取这些信息。例如，通过

os.getenv('DB_PASSWORD')

来获取密码，或者使用

python-dotenv

等库来加载

.env

文件。

这些实践并非高深莫测，但却是构建健壮、安全、高性能应用不可或缺的环节。

遇到连接MySQL的常见问题及调试技巧有哪些？

在使用PyMySQL连接MySQL时，总会遇到一些让人头疼的问题，有时候一个微小的配置错误就能让你抓狂。我总结了一些常见的痛点和我的调试思路：

Can't connect to MySQL server on 'host' (111)

或类似的连接拒绝错误。 这是最常见的连接问题，通常意味着客户端无法与MySQL服务器建立网络连接。

检查MySQL服务状态： 确保MySQL服务器正在运行。在Linux上，
```
sudo systemctl status mysql
```
或
```
sudo service mysql status
```
。
检查主机和端口： 确认
```
host
```
参数（如
```
localhost
```
或IP地址）和
```
port
```
参数（默认3306）是否正确。尤其是在Docker容器或云环境中，
```
localhost
```
可能不再适用，需要使用容器名或服务IP。
网络连通性： 尝试从客户端机器
```
ping
```
MySQL服务器的IP地址，或者使用
```
telnet <host> <port>
```
（如
```
telnet localhost 3306
```
）来测试端口是否开放。如果
```
telnet
```
失败，可能是防火墙阻止了连接。
防火墙规则： 检查服务器端的防火墙（如
```
ufw
```
或
```
firewalld
```
）是否允许来自客户端IP的3306端口连接。

Access denied for user 'user'@'host'

错误。 这意味着用户名或密码不正确，或者该用户没有从你的客户端IP地址连接的权限。

核对用户名和密码： 确认连接字符串中的
```
user
```
和
```
password
```
是否与MySQL数据库中设置的完全一致。大小写敏感性也需要注意。
检查用户权限： 登录到MySQL服务器，使用
```
SELECT user, host FROM mysql.user;
```
查看用户列表，并使用
```
SHOW GRANTS FOR 'your_username'@'your_host';
```
检查该用户是否有从
```
your_host
```
连接的权限。
```
your_host
```
可以是
```
localhost
```
、
```
%
```
（表示任意主机）或特定的IP地址。如果用户只能从
```
localhost
```
连接，而你的应用是从远程连接，就会出现这个错误。

Unknown database 'db_name'

错误。 这个比较直接，就是你指定的数据库名不存在，或者打错了。

确认数据库名： 登录MySQL，使用
```
SHOW DATABASES;
```
命令核对数据库名称。

4. 字符编码问题，如中文乱码。 数据插入或查询时出现乱码，往往是字符编码不一致造成的。

PyMySQL连接参数： 在
```
pymysql.connect()
```
中明确指定
```
charset='utf8mb4'
```
。
```
utf8mb4
```
是
```
utf8
```
的超集，能更好地支持Emoji等特殊字符。
数据库和表编码： 确保MySQL数据库、表和字段的字符集都是
```
utf8mb4
```
。可以通过
```
SHOW CREATE DATABASE your_database;
```
和
```
SHOW CREATE TABLE your_table;
```
来检查。
客户端环境： 确保你的Python脚本文件本身也是以UTF-8编码保存的。

调试技巧：

逐步打印连接参数： 在
```
pymysql.connect()
```
之前，
```
print
```
出你正在使用的
```
host
```
、
```
user
```
、
```
password
```
、
```
database
```
、
```
port
```
等参数，确保它们是预期的值。
MySQL日志： 检查MySQL服务器的错误日志（通常在
```
/var/log/mysql/error.log
```
或
```
/var/log/mysqld.log
```
），它会记录连接失败或权限拒绝的详细信息。
使用命令行工具测试： 在出现问题的客户端机器上，尝试使用MySQL客户端命令行工具（
```
mysql -h <host> -u <user> -p <password> -P <port> -D <database>
```
）进行连接，如果命令行也无法连接，那问题肯定出在网络、权限或MySQL服务本身，与Python代码无关。