最可靠方式是用subprocess.run()调用mysqldump官方工具，禁用shell=True，通过--defaults-file读取600权限配置文件避免明文密码，显式设置check=False并校验returncode与stderr，配合--single-transaction、--routines等参数确保一致性与完整性。
直接用 subprocess 调用 mysqldump 最可靠
Python 本身不内置 MySQL 备份能力，硬写 SQL 导出逻辑既不安全也不完整（比如触发器、存储过程、字符集、权限语句都难覆盖）。mysqldump 是官方推荐且经过充分验证的工具，Python 只需负责调用它、捕获结果、处理文件即可。
别用 os.system() —— 它无法可靠获取返回码和 stderr，出错时连“密码错误”还是“库不存在”都分不清。必须用 subprocess.run() 并显式设置 capture_output=True 和 text=True。
-
mysqldump必须已安装并可在 shell 中直接执行（即在$PATH里），否则会报FileNotFoundError - 敏感参数如
-p密码不能拼在命令行里（会泄露到ps或 shell 历史），应改用配置文件或环境变量 - 务必检查
result.returncode：0 表示成功；非 0 时，result.stderr才是真实错误来源（比如mysqldump: Got error: 1045: Access denied for user）
用 my.cnf 配置文件避免明文密码
把账号密码写进命令行是运维事故高发区。mysqldump 支持读取 ~/.my.cnf（Linux/macOS）或 %APPDATA%\MySQL\my.ini（Windows），优先级高于命令行参数。
配置文件内容示例（注意权限：Linux/macOS 上必须 chmod 600 ~/.my.cnf，否则 mysqldump 拒绝读取）：
立即学习“Python免费学习笔记（深入）”；
[client] host = localhost user = backup_user password = your_strong_password port = 3306
- 配置节名必须是
[client]，不是[mysqldump]（后者只影响部分选项，不包含认证） - 如果备份远程库，
host不能省略；本地 socket 连接可加socket = /var/run/mysqld/mysqld.sock - Python 调用时，只需传
--defaults-file=/path/to/my.cnf，其他参数如--databases、--single-transaction照常加
subprocess.run() 完整调用示例
以下代码片段能实际运行，覆盖常见需求：单库/多库导出、压缩、时间戳命名、错误中止：
import subprocess
import datetime
import os
<p>db_names = ["app_db", "log_db"]
backup<em>dir = "/backups/mysql"
now = datetime.datetime.now().strftime("%Y%m%d</em>%H%M%S")
dump_file = os.path.join(backup_dir, f"full<em>backup</em>{now}.sql.gz")</p><p>cmd = [
"mysqldump",
"--defaults-file=/home/user/.my.cnf",
"--single-transaction",
"--routines",
"--triggers",
"--events",
] + db_names</p><p>try:
with open(dump_file, "wb") as f:
result = subprocess.run(
cmd,
stdout=subprocess.PIPE,
stderr=subprocess.PIPE,
check=False # 不自动抛异常，我们自己判断
)
if result.returncode != 0:
raise RuntimeError(f"mysqldump failed: {result.stderr.decode().strip()}")</p><h1>管道压缩，避免生成中间大文件</h1><pre class='brush:python;toolbar:false;'> subprocess.run(["gzip"], stdin=result.stdout, stdout=f, check=True)except Exception as e: print(f"Backup failed: {e}")
这里可加告警、清理残留文件等逻辑
-
--single-transaction对 InnoDB 表保证一致性快照，但对 MyISAM 无效（需配合--lock-all-tables） -
--routines和--triggers默认不启用，漏掉会导致还原后功能异常 - 不要用
shell=True：它会让gzip无法正确接收mysqldump的 stdout，且引入 shell 注入风险
备份失败最常被忽略的三个点
很多脚本本地测试通，一上生产就挂，问题往往不在 Python 代码本身：
-
mysqldump用户权限不足：至少需要SELECT+LOCK TABLES（或RELOAD配合--single-transaction），以及对mysql.proc的EXECUTE（否则--routines报错） - 磁盘空间预估错误：
mysqldump输出的是文本 SQL，通常比 InnoDB 数据文件小，但比压缩后大 3–5 倍；临时目录（/tmp）空间不够会导致Broken pipe - 时区与字符集混乱：如果数据库用
utf8mb4但mysqldump没加--default-character-set=utf8mb4，还原时可能乱码；建议显式指定
备份不是“跑通就行”，关键在可还原性。每次生成备份后，用 gunzip -t 校验压缩包完整性，再抽一个表做 head -n 100 看开头是否含 CREATE TABLE 和正确的字符集声明。
