Docker容器内pyodbc连接SQL Server报ODBC Driver 17找不到错误

问题根因 #

该报错和unixODBC小版本差异无关，核心原因是容器内仅安装了unixODBC驱动管理组件，未安装ODBC Driver 17 for SQL Server驱动本体。本地环境可正常运行是因为本地调试机已提前安装对应微软ODBC驱动。

排查步骤 #

1. 进入运行中的容器执行以下命令，验证当前驱动注册情况：

odbcinst -j

2. 查看命令输出中DRIVERS配置项对应的文件路径（默认一般为/etc/odbcinst.ini），打印该文件内容：

cat /etc/odbcinst.ini

若输出中不存在[ODBC Driver 17 for SQL Server]段落，即可确认是驱动缺失导致的报错。

离线安装方案（适配无法连接deb.debian.org的场景） #

因实例无法访问官方debian源，无需配置在线软件源，直接通过离线deb包安装即可：

• 提前在可联网的同amd64架构机器上，下载与容器系统版本匹配的msodbcsql17离线deb安装包，若需要命令行调试工具可同步下载mssql-tools包，将安装包存入项目构建目录的deps文件夹
• 在Dockerfile中添加以下构建逻辑，全程无需访问外网源：

# 拷贝本地离线安装包到镜像内
COPY ./deps/msodbcsql17_*.deb /tmp/
# 可选：拷贝sqlcmd工具离线包
COPY ./deps/mssql-tools_*.deb /tmp/

RUN apt-get update && \
    # 预写入许可协议配置，避免安装过程交互阻塞
    echo "msodbcsql17 msodbcsql17/accept_eula boolean true" | debconf-set-selections && \
    # 安装本地deb包，自动解决本地源内存在的依赖
    apt-get install -y /tmp/*.deb && \
    # 清理安装缓存减小镜像体积
    rm -rf /var/lib/apt/lists/* /tmp/*.deb

常见补坑 #

安装完成后如果仍报相同错误，执行以下命令检查驱动动态链接库依赖是否完整：

ldd /opt/microsoft/msodbcsql17/lib64/libmsodbcsql-17.*.so

如果输出中有标记为not found的依赖项，按缺失的依赖名下载对应离线deb包，按上述相同逻辑打入镜像即可，最常见的缺失依赖为libssl1.1。
如果需要快速验证驱动可用性，可在启动容器时将本地机器的驱动配置和驱动目录挂载进容器，验证通过后再做镜像固化：

docker run -v /etc/odbcinst.ini:/etc/odbcinst.ini -v /opt/microsoft/:/opt/microsoft/ 你的镜像名

注：unixodbc-dev 2.3.6与运行时unixODBC 2.3.11的小版本差异不会触发该驱动找不到的问题，无需在版本匹配上额外花费排查时间。

内容的提问来源于stack exchange，提问作者B. Youngman