要通过 python 连接 mysql，需安装 mysql-connector-python 或 pymysql 库，并正确配置连接参数。1. 安装库：使用 pip install mysql-connector-python 或 pip install pymysql；2. 准备连接信息：包括 host、port、user、password 和 database；3. 编写代码建立连接并执行查询；4. 常见问题处理：连接超时检查防火墙和远程访问设置，认证错误检查用户名和密码，数据库不存在则检查拼写或创建数据库；5. 推荐使用连接池或上下文管理器提高性能和安全性。按照步骤操作即可实现稳定连接。
安装好 MySQL 后，想通过 Python 进行连接和操作，其实并不复杂。只要准备好环境、安装合适的库，并写对代码，就能顺利连接数据库并进行查询或更新操作。
安装必要的 Python 库
Python 本身不自带连接 MySQL 的模块，需要额外安装第三方库。最常用的是 mysql-connector-python 和 pymysql，两者用法类似，这里以 mysql-connector-python 为例：
pip install mysql-connector-python
如果你使用的是旧项目或者有兼容性需求，也可以选择安装 pymysql：
立即学习“Python免费学习笔记（深入）”；
pip install pymysql
安装完成后就可以开始写代码连接数据库了。
编写连接代码的几个关键点
要成功连接到 MySQL 数据库，你需要准备以下几个信息：
- 主机地址（host）
- 端口号（port，默认是 3306）
- 用户名（user）
- 密码（password）
- 要连接的数据库名称（database）
下面是一个使用 mysql-connector-python 的简单示例：
import mysql.connector
conn = mysql.connector.connect(
host="localhost",
user="root",
password="your_password",
database="test_db"
)
cursor = conn.cursor()
cursor.execute("SELECT * FROM users")
result = cursor.fetchall()
for row in result:
print(row)如果是用 pymysql，只需要把 mysql.connector.connect 替换成 pymysql.connect，其他语法基本一致。
注意：如果连接失败，先检查用户名、密码是否正确，以及数据库是否允许远程访问（特别是跨服务器的情况）。
常见问题及处理建议
-
连接超时
- 检查防火墙设置，确认端口 3306 是否开放。
- 如果是远程数据库，确认 MySQL 是否配置为允许远程访问（修改
bind-address或使用GRANT授权用户）。
-
认证错误
- 用户名或密码错误是最常见的原因，可以登录 MySQL 命令行执行
SELECT User, Host FROM mysql.user;查看可用账号。
- 用户名或密码错误是最常见的原因，可以登录 MySQL 命令行执行
-
找不到数据库
- 检查 database 参数拼写是否正确，或者目标数据库是否存在。
-
依赖缺失或版本冲突
- 如果提示缺少某些依赖，尝试升级 pip 并重新安装库：
pip install --upgrade pip pip install --force-reinstall mysql-connector-python
- 如果提示缺少某些依赖，尝试升级 pip 并重新安装库：
小贴士：连接池和上下文管理器更安全
为了提高性能和避免资源泄漏，推荐使用连接池（如 mysql-connector 的 PoolingMySQLConnection）或结合上下文管理器自动关闭连接：
from mysql.connector import pooling
connection_pool = pooling.MySQLConnectionPool(
pool_name="mypool",
pool_size=5,
host="localhost",
user="root",
password="your_password",
database="test_db"
)
conn = connection_pool.get_connection()
with conn.cursor() as cursor:
cursor.execute("SELECT COUNT(*) FROM users")
print(cursor.fetchone())这样可以在连接使用完后自动释放资源，避免长时间占用数据库连接。
基本上就这些。Python 连接 MySQL 不难，但要注意细节，比如权限、网络、库版本等，有时候一个小配置不对就会连不上。按照上面的方法一步步来，一般都能搞定。
