Symfony 6.3 Docker部署PostgreSQL：生产环境无数据问题排查

核心问题定位 #

从Call to undefined function pg_connect()报错和phpinfo无PostgreSQL相关编译配置可以确定：生产环境的PHP-fpm-alpine容器没有成功安装PostgreSQL扩展，这是导致无法读取数据库的根本原因。开发环境正常是因为其PHP环境已预装或正确安装了对应扩展。

步骤1：修正Dockerfile中的PostgreSQL扩展安装命令 #

针对php-fpm-alpine镜像，正确安装pdo_pgsql和pgsql扩展需要包含依赖安装、扩展编译和清理步骤，示例如下：

# 安装alpine环境下编译扩展所需的依赖
RUN apk add --no-cache postgresql-dev \
    # 安装并启用PHP的PostgreSQL扩展
    && docker-php-ext-install pdo_pgsql pgsql \
    # 清理依赖包以减小镜像体积
    && apk del postgresql-dev

注意：如果使用多阶段构建，必须确保扩展安装在最终运行阶段，或者从构建阶段将已编译好的扩展文件复制到运行镜像中，否则扩展不会存在于生产容器内。

步骤2：排查生产环境Docker构建问题 #

1. 强制重新构建镜像：避免使用旧的缓存层导致扩展安装步骤被跳过，执行以下命令：

   docker build --no-cache -t your-php-image .
   

   查看构建日志，确认扩展安装步骤没有报错（比如依赖缺失、编译失败等），如果有错误，可尝试指定具体版本的alpine镜像（如php:8.2.11-fpm-alpine3.18）。

2. 验证容器内扩展状态：进入生产容器执行命令，确认扩展已加载：

   # 进入容器
   docker exec -it your-php-container sh
   # 查看已加载的PHP模块
   php -m | grep pgsql
   # 查看PostgreSQL扩展配置详情
   php -i | grep -A 10 "pgsql"
   

   如果输出中没有pdo_pgsql和pgsql，说明扩展未安装成功，需重新检查Dockerfile。

步骤3：Symfony生产环境额外检查 #

1. 确认数据库连接配置：确保生产环境.env或.env.prod中的DATABASE_URL为PostgreSQL格式：

   DATABASE_URL="pgsql://db_user:db_password@db_host:5432/db_name?serverVersion=15&charset=utf8"
   

2. 清除生产环境缓存：扩展安装完成后，必须清除Symfony生产缓存：

   php bin/console cache:clear --env=prod
   

开发/生产环境差异原因解释 #

• 开发环境可能使用了本地PHP环境（已预装PostgreSQL扩展），或者开发容器的Dockerfile正确执行了扩展安装步骤。
• 生产环境构建时依赖旧的Docker缓存层，导致扩展安装步骤被跳过，--no-cache参数可强制重新执行所有构建步骤。
• 多阶段构建时，如果仅在构建阶段安装了扩展，却未将/usr/local/lib/php/extensions/下的扩展文件复制到运行阶段，最终容器会缺少扩展。

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