PHP/Laravel执行mysqldump命令返回码2失败求助

以下是针对返回码2的常见排查和解决方法：

1. 使用mysqldump的绝对路径 #

PHP运行时的环境变量（如PATH）和手动执行命令的环境可能不同，导致找不到mysqldump可执行文件：

• 先在服务器终端执行 which mysqldump，得到绝对路径（例如/usr/bin/mysqldump）
• 将命令中的mysqldump替换为该绝对路径

2. 修复目录权限问题 #

确保public/DBbackup目录对PHP运行用户（通常是www-data、nginx或apache）有写入权限：

• 执行终端命令：chown -R www-data:www-data public/DBbackup
• 或调整目录权限：chmod 755 public/DBbackup

3. 安全转义命令参数 #

直接拼接env变量可能因特殊字符（如密码中的!、$等）导致命令解析错误，用escapeshellarg()转义每个参数：

$filename = "backup-" . Carbon::now()->format('Y-m-d') . ".gz";
$username = escapeshellarg(env('DB_USERNAME'));
$password = escapeshellarg(env('DB_PASSWORD'));
$database = escapeshellarg(env('DB_DATABASE'));
$backupPath = escapeshellarg(public_path("DBbackup/{$filename}"));

// 注意-p和密码之间不要加空格
$command = "/usr/bin/mysqldump -u {$username} -p{$password} {$database} --no-tablespaces | gzip > {$backupPath}";

exec($command, $output, $returnVar);

4. 改用配置文件读取参数（生产环境） #

Laravel生产环境启用配置缓存后，env()函数会失效，应通过配置文件读取数据库参数：

$username = config('database.connections.mysql.username');
$password = config('database.connections.mysql.password');
$database = config('database.connections.mysql.database');

5. 捕获完整错误信息 #

exec默认只捕获标准输出，错误信息在标准错误流，修改命令将错误重定向到输出以便排查：

$command = "/usr/bin/mysqldump ... | gzip > {$backupPath} 2>&1";
exec($command, $output, $returnVar);
print_r($output); // 打印错误详情

内容的提问来源于stack exchange，提问作者Omar Yacop