Docker容器连接求助：SQL Server与Jupyter Lab报IM004错误

你遇到的IM004错误是ODBC驱动管理器无法正确加载SQL Server驱动导致的，结合主机环境连接正常的情况，问题核心是Jupyter容器内的ODBC驱动安装或配置不完整。以下是分步排查修复方案：

1. 安装微软官方SQL Server ODBC驱动 #

unixODBC只是驱动管理器，你还需要安装微软提供的ODBC Driver 17 for SQL Server实际驱动包。进入Jupyter容器执行以下命令（基于Debian/Ubuntu系镜像，Jupyter官方镜像默认是该体系）：

# 进入容器
docker exec -it jupytercontainername bash

# 添加微软软件源
curl https://packages.microsoft.com/keys/microsoft.asc | apt-key add -
curl https://packages.microsoft.com/config/debian/11/prod.list > /etc/apt/sources.list.d/mssql-release.list

# 更新源并安装驱动
apt-get update
ACCEPT_EULA=Y apt-get install -y msodbcsql17

2. 修正odbcinst.ini驱动配置 #

确保/etc/odbcinst.ini中的驱动路径与实际安装的文件一致：

1. 查找驱动文件实际路径：

find /opt/microsoft -name "libmsodbcsql*.so"

2. 编辑/etc/odbcinst.ini，替换为正确的配置（示例路径以实际查找结果为准）：

[ODBC Driver 17 for SQL Server]
Description=Microsoft ODBC Driver 17 for SQL Server
Driver=/opt/microsoft/msodbcsql17/lib64/libmsodbcsql-17.10.so.1.1
UsageCount=1

3. 配置LD_LIBRARY_PATH环境变量 #

确保驱动的库目录被加载到系统路径：

• 临时生效（容器内执行）：

export LD_LIBRARY_PATH="$LD_LIBRARY_PATH:/opt/microsoft/msodbcsql17/lib64"

• 永久生效（修改容器启动参数）：
  启动Jupyter容器时添加环境变量参数：

docker run --rm -t -d --name=jupytercontainername \
  -p 8888:8888 \
  --mount src="$(pwd)",target="/Users",type=bind \
  --network networkname \
  -e LD_LIBRARY_PATH="/opt/microsoft/msodbcsql17/lib64" \
  jupyterimagename

4. 测试ODBC基础连通性 #

安装unixodbc-bin工具测试驱动是否正常工作：

apt-get install -y unixodbc-bin
# 测试连接，替换为你的容器名称和密码
isql -v "ODBC Driver 17 for SQL Server" sqlcontainername,1433 sa sqlpassword

如果返回Connected!，说明ODBC配置已修复。

5. Jupyter内的连接代码验证 #

pyodbc连接示例 #

import pyodbc

conn_str = (
    "DRIVER={ODBC Driver 17 for SQL Server};"
    "SERVER=sqlcontainername,1433;"
    "DATABASE=master;"
    "UID=sa;"
    "PWD=sqlpassword;"
)
try:
    conn = pyodbc.connect(conn_str)
    print("连接成功")
except Exception as e:
    print(f"连接失败: {str(e)}")

SQL Magic连接示例 #

%load_ext sql
%sql mssql+pyodbc://sa:sqlpassword@sqlcontainername:1433/master?driver=ODBC+Driver+17+for+SQL+Server

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