Docker+WSL环境连接PostgreSQL提示‘could not find driver’求助

问题根源 #

你的Dockerfile基于php:fpm-alpine镜像，编译安装PHP的PostgreSQL扩展（pgsql和pdo_pgsql）时缺少必要依赖。Alpine系统下，这类扩展的编译需要postgresql-dev和libpq库支持，直接执行docker-php-ext-install会导致扩展编译失败，容器内实际并未生成可用的PDO驱动。

修改后的Dockerfile #

ARG PHP_VERSION=""
FROM php:${PHP_VERSION:+${PHP_VERSION}-}fpm-alpine

# 更新系统并安装PostgreSQL扩展编译依赖
RUN apk update && apk upgrade && \
    apk add --no-cache postgresql-dev libpq && \
    # 安装PHP核心及数据库扩展
    docker-php-ext-install \
        pdo \
        pdo_mysql \
        mysql \
        mysqli \
        pgsql \
        pdo_pgsql && \
    # 清理编译依赖以减小镜像体积
    apk del postgresql-dev

# 原有GD与mcrypt扩展安装逻辑保持不变
RUN apk add \
    --no-cache \
        freetype \
        libpng \
        libjpeg-turbo \
        freetype-dev \
        libpng-dev \
        libjpeg-turbo-dev \
        libmcrypt-dev \
    && docker-php-ext-configure gd \
        --with-gd \
        --with-freetype-dir=/usr/include/ \
        --with-png-dir=/usr/include/ \
        --with-jpeg-dir=/usr/include/ \
    && NPROC=$(grep -c ^processor /proc/cpuinfo 2>/dev/null || 1) \
    && docker-php-ext-install -j${NPROC} gd \
    && apk del \
        --no-cache \
            freetype-dev \
            libpng-dev \
            libjpeg-turbo-dev \
    && docker-php-ext-install mcrypt

关键修改说明 #

• 先通过apk add postgresql-dev libpq安装依赖：
  • postgresql-dev：提供编译PostgreSQL扩展所需的头文件
  • libpq：PostgreSQL客户端运行库，是扩展运行时的必要依赖
• 扩展安装完成后删除postgresql-dev，避免镜像体积冗余

验证扩展安装状态 #

重新构建镜像并启动容器后，进入容器执行以下命令确认驱动存在：

# 检查已加载的PHP扩展
php -m | grep -E "pgsql|pdo_pgsql"
# 或查看PDO配置细节
php -i | grep pdo_pgsql

输出包含pgsql和pdo_pgsql则说明扩展安装成功。

额外连接注意事项 #

由于PostgreSQL部署在WSL内，容器连接时需确认：

1. PostgreSQL配置文件postgresql.conf中设置listen_addresses = '*'，允许外部连接
2. pg_hba.conf添加允许Docker网段访问的规则（例如host all all 172.17.0.0/16 md5）
3. 连接地址不能用localhost，需填写WSL的实际IP（WSL终端执行hostname -I获取），或启动容器时使用--network host模式直接共享主机网络

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