很多老项目或特定开发环境仍然需要用到 Python 3.4 版本。虽然该版本已经停止官方维护，但配合合适的 MySQL 驱动依然可以稳定运行。本教程将一步步带你完成在 Windows 和 Linux 环境下，使用 Python 3.4 连接和操作 MySQL 数据库的完整流程，重点解决版本兼容性与环境配置问题。
准备工作与环境核对
在安装之前，请确认你的系统已经部署了 MySQL 服务。推荐使用 MySQL 5.7 或 8.0 版本，两者对旧版 Python 都保持较好的协议兼容性。同时确保 Python 3.4 已经正确安装，并且环境变量 path 已配置完毕。打开命令行输入 python --version，看到版本号即可继续。由于 Python 3.4 年代较早，现代包管理器可能会拉取不兼容的依赖，因此我们需要手动锁定历史可用版本，避免后续出现导入报错。
安装 MySQL 数据库服务
Windows 用户建议下载 MySQL Installer 安装包，选择 Standard 模式一路默认安装即可。记得设置 root 密码并记住端口号，默认为 3306。Linux 用户可以使用包管理器直接安装，例如在 Ubuntu 下执行 sudo apt-get update && sudo apt-get install mysql-server。安装完成后启动服务，并通过 mysql -u root -p 验证是否能正常登录。如果提示找不到命令，请检查系统是否自动添加了环境变量，或者直接使用绝对路径调用 mysql 客户端。
为 Python 3.4 安装 MySQL 驱动
Python 标准库没有内置 MySQL 连接模块，必须借助第三方库。最稳定的选择是 PyMySQL，它是纯 Python 编写的，不需要编译底层 C 语言库，非常适合老旧的 Python 版本。打开命令行，切换到 Python 3.4 的安装目录下的 Scripts 文件夹，执行 pip install PyMySQL==0.7.11。这个版本是最后一个完全支持 Python 3.4 的发布版。如果你更倾向于性能更好的 mysqlclient，则需要先安装 C 编译器和 MySQL 开发头文件，然后使用 pip install mysqlclient==1.3.14 进行安装。遇到编译报错时，优先回退到 PyMySQL。
测试数据库连接
驱动安装成功后，写一段简单的测试代码验证连通性。新建一个 test_db.py 文件，写入以下代码：
import pymysql
conn = pymysql.connect(host='localhost', port=3306, user='root', password='你的密码', database='test', charset='utf8mb4')
cursor = conn.cursor()
cursor.execute('SELECT VERSION()')
data = cursor.fetchone()
print('数据库版本:', data)
cursor.close()
conn.close()
使用 python test_db.py 运行。如果终端打印出数据库版本号，说明环境打通。如果出现权限拒绝，请检查 MySQL 用户授权；如果出现编码错误，确保建表时指定 utf8mb4 字符集，并在连接参数中显式声明 charset。
基础增删改查操作示例
连接建立后，日常开发离不开数据操作。插入数据需要使用 execute 方法配合参数化查询防止注入。例如 cursor.execute('INSERT INTO users(name, age) VALUES(%s, %s)', ('张三', 25))，之后调用 conn.commit() 提交事务。查询操作推荐使用字典游标 cursor = conn.cursor(pymysql.cursors.DictCursor)，这样返回的结果可以直接按字段名取值。删除和更新同理，写完语句后务必调用 commit。最后养成习惯，无论成功失败都在 finally 块里关闭游标和连接，避免资源泄漏。
常见问题排查指南
运行时报 ModuleNotFoundError 通常是因为 pip 指向了其他 Python 版本，请在命令行明确指定 python3.4 或完整路径执行安装。连接超时或 2003 错误多半是防火墙拦截或 MySQL 未监听本地地址，可以在 my.cnf 中检查 bind-address 设置。乱码问题几乎都出在字符集配置上，除了代码里指定 charset，还要检查 MySQL 服务器默认的 collation 是否为 utf8mb4_general_ci。遇到无法解决的编译报错，直接使用 PyMySQL 是最稳妥的替代方案。
强烈建议使用 virtualenv 或 venv 为 Python 3.4 创建独立虚拟环境。老版本的基础库经常引发冲突，隔离环境能避免污染系统全局包。创建后激活环境再执行 pip install，所有依赖都会集中存放在当前项目目录下。迁移服务器时直接打包整个虚拟环境文件夹，或者导出 requirements.txt 清单，能大幅降低部署难度。按照以上步骤操作，Python 3.4 与 MySQL 的对接就能顺利跑通，配合完善的异常捕获机制，足以支撑稳定的业务逻辑。
