最可靠方式是用subprocess.run()调用mysqldump官方工具，禁用shell=true，通过--defaults-file读取600权限配置文件避免明文密码，显式设置check=false并校验returncode与stderr，配合--single-transaction、--routines等参数确保一致性与完整性。

如何用python自动化备份mysql数据库文件_调用mysqldump命令

直接用 `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 拒绝读取）：

Li Python Sec Check

Python 安全规范检查工具：基于 CloudBase 规范、腾讯安全指南，LLM 智能分析（默认禁用，优先本地执行）

下载

[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，还原时可能乱码；建议显式指定