Symfony6.01 Command调用pg_dump备份PostgreSQL11生成空SQL文件异常

问题表现 #

• Web端通过Controller触发备份命令时，生成的SQL备份文件为空，Symfony开发日志、PostgreSQL服务日志均无报错记录
• 将代码生成的备份命令复制到服务器终端手动执行，备份文件内容完整正常
• 限制条件：无法通过独立shell脚本实现备份逻辑

原备份命令实现代码：

<?php

namespace App\XXXXXX\YYYYYYBundle\Command;

use Symfony\Component\Console\Attribute\AsCommand;
use Symfony\Component\Console\Command\Command;
use Symfony\Component\Console\Input\InputArgument;
use Symfony\Component\Console\Input\InputInterface;
use Symfony\Component\Console\Output\OutputInterface;
use Symfony\Component\HttpKernel\KernelInterface;
use Symfony\Component\Process\Process;

#[AsCommand(
    name: 'xxxxx:dump-database',
    description: 'Creates a xxxxx database dump.',
    aliases: ['xxxxx:dump-database'],
    hidden: false,
)]
class DatabaseDumpCommand extends Command
{
    /**
     * @var string
     */
    private string $rootDir;
    /**
     * @var string
     */
    private string $databaseHost;
    /**
     * @var string
     */
    private string $databaseName;
    /**
     * @var string
     */
    private string $databaseUser;
    /**
     * @var string
     */
    private string $databasePW;

    /**
     * @param string $databaseHost
     * @param string $databaseName
     * @param string $databaseUser
     * @param string $databasePW
     * @param KernelInterface $kernel
     */
    public function __construct(
        string $databaseHost,
        string $databaseName,
        string $databaseUser,
        string $databasePW,
        KernelInterface $kernel)
    {
        $this->databaseName = $databaseName;
        $this->databaseUser = $databaseUser;
        $this->databaseHost = $databaseHost;
        $this->databasePW = $databasePW;
        $this->rootDir = $kernel->getProjectDir();

        parent::__construct();
    }


    protected function configure(): void
    {
        parent::configure();

        $this
            ->addArgument('file-name',  InputArgument::OPTIONAL, 'Name of dump file')
            ->addArgument('time',  InputArgument::OPTIONAL, 'created at')
        ;
    }

    public function execute(InputInterface $input, OutputInterface $output): int
    {
        set_time_limit(0);

        $time = $input->getArgument('time');
        if (!$time) {
            $time = date('Y-m-dH:i:s');
        }

        $fileName = $input->getArgument('file-name');
        if(!$fileName) {
            $fileName = "xxxxxDbDump";
        }

        $fileName .= "$time.sql";

        $backupPath =  $this->rootDir."/DUMPS/";

        $backupPathTemp = '/tmp/';

        $path = "/usr/bin/pg_dump";

        $sqlQuery = "export PGPASSWORD='$this->databasePW';$path --host=$this->databaseHost --port=5432 --username=$this->databaseUser --create --clean
    --verbose $this->databaseName > $backupPathTemp$fileName;cp /tmp/$fileName $backupPath$fileName";

        //echo $sqlQuery;

        $cmd = method_exists(Process::class, 'fromShellCommandline') ? Process::fromShellCommandline($sqlQuery, null, null, null, null) : new Process($sqlQuery, null, null, null, null);


        /** @var Process $cmd */
        $cmd->run();
        if (!$cmd->isSuccessful()) {
            return false;
        }
        return true;
    }
}

核心问题原因 #

1. 运行用户权限/环境差异
   终端手动执行命令时，使用的是当前登录的服务器用户（通常是root或具备完整权限的运维用户），该用户的环境变量配置、PostgreSQL认证规则、目录读写权限、pg_dump执行权限都是完整的。而Web请求触发Controller时，PHP进程运行在Web服务用户下（常见如www-data、nginx、apache），该用户默认没有上述权限，也不会加载交互式shell的环境配置，pg_dump实际执行时会因为拿不到密码、没有权限、认证失败等原因静默退出，没有任何内容输出。
2. Process组件用法错误
   • 不应该通过shell拼接export PGPASSWORD的方式传递密码，Symfony Process启动的是非交互式shell，不会保留export设置的环境变量，pg_dump执行时根本获取不到密码，直接连接失败。
   • 命令字符串中--clean和--verbose之间存在换行+多余缩进，非交互式shell解析参数时可能出现参数截断，导致命令执行逻辑异常。
   • 执行后没有调用$cmd->getErrorOutput()捕获错误输出，直接吞掉了所有报错信息，导致日志里查不到失败原因。
   • execute方法返回值不符合规范，Console Command要求返回Command::SUCCESS或Command::FAILURE常量（对应整型0/1），直接返回布尔值会导致状态判断异常。
3. Shell逻辑兼容问题
   直接在命令字符串中使用>重定向输出、cp复制文件的逻辑强依赖当前系统的shell实现，部分服务器默认使用的sh shell和常用的bash语法存在差异，重定向逻辑可能失效，最终生成空文件。另外生成的备份文件名中时间部分包含冒号，部分文件系统下冒号是非法文件名字符，也可能导致写入失败。

修复方案 #

1. 权限配置前置
   给Web运行用户授予必要权限：授予pg_dump可执行权限，给项目下的DUMPS目录、/tmp目录添加Web用户的写权限；检查PostgreSQL的pg_hba.conf配置，放通Web服务器来源的密码认证请求。
2. 修正Process调用逻辑
   不要在命令字符串里拼接环境变量、重定向、文件复制逻辑，通过Process的环境变量参数传递PGPASSWORD，命令只保留pg_dump的核心参数，执行后拿到输出内容直接通过PHP写入目标文件，避免shell兼容问题。
3. 补充错误捕获
   执行命令后获取错误输出，出现异常时直接打印或写入日志，方便排查问题。
4. 修正返回值与文件名规范
   时间格式去掉冒号，改用下划线或横杠分隔；execute方法返回Command类规定的成功/失败常量。

修复后的execute方法参考：

public function execute(InputInterface $input, OutputInterface $output): int
{
    set_time_limit(0);

    $time = $input->getArgument('time') ?: date('Y-m-d_H_i_s');
    $fileName = ($input->getArgument('file-name') ?: "xxxxxDbDump") . "_{$time}.sql";
    $backupPath = $this->rootDir."/DUMPS/";
    // 提前检查目录存在，不存在则创建
    if (!is_dir($backupPath)) {
        mkdir($backupPath, 0755, true);
    }
    $fullFilePath = $backupPath . $fileName;

    // 构造pg_dump命令参数，不要拼接shell逻辑，不要换行
    $cmd = [
        '/usr/bin/pg_dump',
        '--host=' . $this->databaseHost,
        '--port=5432',
        '--username=' . $this->databaseUser,
        '--create',
        '--clean',
        $this->databaseName
    ];

    // 直接通过Process参数传递环境变量，不需要export
    $env = array_merge($_ENV, [
        'PGPASSWORD' => $this->databasePW
    ]);

    $process = new Process($cmd, null, $env);
    $process->run();

    // 捕获错误输出，执行失败时直接输出错误
    if (!$process->isSuccessful()) {
        $output->writeln('备份失败：' . $process->getErrorOutput());
        return Command::FAILURE;
    }

    // 直接把命令输出写入文件，不需要shell重定向和cp
    file_put_contents($fullFilePath, $process->getOutput());

    $output->writeln('备份成功，文件路径：' . $fullFilePath);
    return Command::SUCCESS;
}

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