Docker容器中Symfony恢复PostgreSQL数据库失败问题排查

1. 命令在终端正常但应用内执行失败的原因 #

• 容器内缺少Docker CLI工具：你在终端执行命令时，是在宿主机或装有Docker环境的终端中运行，但Apache-PHP容器内部并没有安装Docker客户端（docker命令不存在），导致proc_open找不到docker命令触发错误。
• 权限与Socket访问问题：即便容器内安装了Docker CLI，应用运行的用户（如www-data）通常没有权限访问宿主机的Docker Socket，无法执行docker exec命令。
• 文件路径不互通：SQL文件存储在Apache-PHP容器的/var/www/var/dump/，但目标数据库容器（safebase-backup-1）并没有挂载这个目录，在数据库容器内找不到指定的SQL文件；终端执行时依赖宿主机的路径映射，但容器内执行时路径完全隔离。

2. 解决proc_open(): posix_spawn() failed错误的方案 #

方案一：直接连接数据库（推荐，符合Docker最佳实践） #

放弃在容器内调用docker exec，直接在Apache-PHP容器中使用psql客户端连接数据库容器的服务端口，无需依赖Docker CLI：

1. 确保Apache-PHP容器内安装了PostgreSQL客户端：在PHP镜像的Dockerfile中添加：

RUN apt-get update && apt-get install -y postgresql-client

2. 修改RestoreService中的恢复命令，直接连接数据库服务（假设Docker Compose中备份数据库的服务名为safebase-backup）：

$restoreCommand = [
    'psql',
    '-h', 'safebase-backup', // 数据库容器的服务名或IP
    '-U', 'user',
    '-d', $databaseName,
    '-f', "/var/www/var/dump/$fileName"
];

3. 确保数据库容器的postgresql.conf允许远程连接，且pg_hba.conf信任Apache-PHP容器的IP段。

方案二：在PHP容器内配置Docker环境（不推荐，有安全风险） #

如果必须使用docker exec，需为PHP容器安装Docker CLI并配置权限：

1. 在PHP镜像的Dockerfile中安装Docker CLI：

RUN apt-get update && apt-get install -y docker.io
RUN usermod -aG docker www-data

2. 在Docker Compose的PHP服务中挂载宿主机的Docker Socket：

services:
  php-apache:
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock

3. 移除命令中的-it参数（Symfony Process不支持交互式终端）：

$restoreCommand = [
    'docker', 'exec', '-i', $targetContainer, 'psql', '-U', 'user', '-d', $databaseName, '-f', "/var/www/var/dump/$fileName"
];

注意：此方案会让容器获得宿主机Docker的完全控制权，存在安全隐患，仅在测试环境或信任的场景中使用。

方案三：共享SQL文件目录到目标数据库容器 #

如果坚持使用docker exec，需将存储SQL文件的目录同步到目标数据库容器：
在Docker Compose中为备份数据库服务添加相同的目录挂载：

services:
  safebase-backup:
    volumes:
      - ./var/dump:/var/www/var/dump # 和PHP容器挂载同一个本地目录

这样目标数据库容器内就能访问到SQL文件，命令即可正常执行。

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