Debian基础Docker镜像安装pdo_pgsql后路由404问题求助

问题场景 #

基于debian:buster-slim构建PHP镜像，需要添加pdo_pgsql扩展，但添加相关安装配置后，项目所有路由返回404；移除该配置后恢复正常。限制条件：

• 必须使用Debian基础镜像以适配SQL Server 2008，无法使用官方docker-php-ext-*工具
• 已尝试修改三个php.ini文件开启扩展，问题仍未解决

手动安装pdo_pgsql的正确步骤（无需docker-php-ext） #

1. 安装依赖包
   先安装PostgreSQL客户端和PHP编译依赖：

   apt-get update && apt-get install -y --no-install-recommends \
       libpq-dev \
       php-dev \
       gcc \
       make
   

2. 编译安装pdo_pgsql扩展
   用pecl工具编译安装（比手动编译更简便）：

   pecl install pdo_pgsql
   

   编译完成后会提示扩展的so文件路径，比如/usr/lib/php/20190902/pdo_pgsql.so（路径随PHP版本变化）

3. 精准配置PHP扩展
   不要盲目修改多个php.ini，先确认PHP实际加载的配置文件：

   php --ini | grep "Loaded Configuration File"
   

   拿到路径后，在该文件末尾添加：

   extension=pdo_pgsql.so
   

   如果系统存在phpenmod命令，也可以在/etc/php/[版本号]/mods-available/下创建pdo_pgsql.ini写入上述内容，再执行phpenmod pdo_pgsql启用扩展

路由404的排查要点 #

• 检查web服务配置完整性：安装扩展过程中可能误修改Apache/PHP-FPM的配置文件，确认文档根目录、重写规则（如.htaccess）是否正常生效
• 验证PHP环境状态：执行php -m确认pdo_pgsql已加载，查看phpinfo()输出，检查PHP运行是否有隐性报错
• 排查项目路由初始化逻辑：如果项目路由依赖数据库连接，可能pdo_pgsql安装后PDO驱动配置出错，导致路由初始化失败，查看项目日志定位具体错误
• 清理项目缓存：安装扩展后清理项目路由缓存（如Laravel执行php artisan route:clear），避免旧缓存引发的路由异常

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