php:7.3-apache镜像Docker容器连接SQL Server提示找不到驱动

API 探路者

2026-9-30

问题排查与解决方案

核心问题原因

你通过pecl安装了sqlsrv和pdo_sqlsrv扩展后，没有执行扩展启用操作，即使手动在php.ini中添加配置，也可能因为配置路径优先级、格式问题导致扩展未实际加载，最终触发"could not find driver"报错。

分步排查解决

第一步：验证扩展是否加载
启动容器后执行命令：
```
docker exec <你的容器名称/ID> php -m | grep sqlsrv
```
如果没有输出sqlsrv和pdo_sqlsrv两行结果，说明扩展未成功加载。

第二步：修正Dockerfile扩展启用逻辑
替换Dockerfile中安装sqlsrv扩展的对应段落，添加docker-php-ext-enable启用命令：

# Install sqlsrv
RUN apt-get update \
    && apt-get install -y wget \
    && wget http://ftp.br.debian.org/debian/pool/main/g/glibc/multiarch-support_2.24-11+deb9u4_amd64.deb \
    && dpkg -i multiarch-support_2.24-11+deb9u4_amd64.deb \
    && apt-get -y install msodbcsql17 unixodbc-dev \
    && pecl install sqlsrv pdo_sqlsrv \
    && docker-php-ext-enable sqlsrv pdo_sqlsrv

官方PHP镜像提供的docker-php-ext-enable命令会自动将扩展配置写入优先级最高的ini文件，避免自定义php.ini配置不生效的问题。

第三步：验证PHP配置加载情况
执行命令确认配置加载路径正确：
```
docker exec <你的容器名称/ID> php --ini
```
确认输出的Loaded Configuration File行指向/usr/local/etc/php/php.ini，如果你保留自定义php.ini的配置，可删除其中手动添加的extension=pdo_sqlsrv.so、extension=sqlsrv.so行，避免重复配置冲突。
第四步：验证PDO驱动
在应用根目录添加临时测试文件test_pdo.php，内容如下：
```
<?php
print_r(PDO::getAvailableDrivers());
```
访问该文件，输出中如果包含sqlsrv说明扩展加载成功，此时再检查应用的数据库连接字符串是否存在拼写错误、账号密码、地址端口配置是否正确即可。