Python调用mysqldump导出数据库时首次报错not found的解决办法

问题分析 #

这个矛盾的现象（首次导出成功但报错，第二次无错误）大概率是第一次运行时，Python脚本所在的Shell环境PATH变量没有包含mysqldump的安装路径，但后续（比如系统环境变量完成初始化、脚本内其他操作触发了PATH更新）第二次运行时PATH已经正确加载了mysqldump的路径。

不过这里有个小细节：既然提示找不到mysqldump，为什么第一次还能导出成功？可能是你的脚本在执行这条命令前，有其他操作间接设置了PATH，或者系统后台刚好在第一次运行时完成了PATH的初始化，导致命令实际执行成功但报错信息已经提前输出了。

解决方案 #

1. 直接使用mysqldump的绝对路径（最稳妥） #

这是规避PATH问题的终极办法，不管环境如何都能准确定位到命令：

• 先在终端执行which mysqldump，获取mysqldump的绝对路径，比如输出可能是/usr/bin/mysqldump或/usr/local/mysql/bin/mysqldump
• 修改你的代码，把mysqldump替换成这个绝对路径：

os.system('/usr/bin/mysqldump -u %s -p%s %s > %s' % (user, password, database, filepath))

2. 在脚本中手动补充PATH环境变量 #

如果不想写死绝对路径，可以在脚本开头手动把mysqldump所在的目录加入到PATH中：

import os
# 替换成你实际的mysqldump所在目录
os.environ['PATH'] += ':/usr/local/mysql/bin'
os.system('mysqldump -u %s -p%s %s > %s' % (user, password, database, filepath))

3. 检查脚本的运行环境 #

如果你的脚本是通过系统服务（如systemd）、定时任务（cron）或者IDE内置终端启动的，这些环境的PATH通常比普通终端更精简。这种情况下：

• 要么用绝对路径执行mysqldump
• 要么在服务配置/定时任务的脚本开头明确设置完整的PATH

额外的安全建议 #

你当前的代码直接把密码拼在命令里，会导致密码明文出现在系统的进程列表中（比如用ps命令就能看到），存在安全风险。更推荐用--defaults-extra-file参数来传递认证信息：

1. 创建一个权限严格的配置文件（比如mysql_dump.cnf），内容如下：

[mysqldump]
user=你的数据库用户名
password=你的数据库密码

2. 设置文件权限为chmod 600 mysql_dump.cnf（确保只有当前用户能读写）
3. 修改导出命令：

os.system('mysqldump --defaults-extra-file=/path/to/mysql_dump.cnf %s > %s' % (database, filepath))

内容的提问来源于stack exchange，提问作者Sandro Mirijanashvili