本文详解在 ubuntu 22.04 docker 容器中安装 microsoft odbc 驱动（msodbcsql18）、配置 pyodbc 连接 sql server 的完整流程，解决“can't open lib 'sql server' : file not found”等常见驱动加载失败问题。
要在 Docker 容器中成功连接 SQL Server，核心前提是：容器内必须安装官方 Microsoft ODBC 驱动（如 msodbcsql18）并正确注册到 unixODBC 驱动管理器。你遇到的错误：
Can't open lib 'SQL Server' : file not found
根本原因在于：'SQL Server' 是旧版驱动别名（已弃用），而 msodbcsql17/msodbcsql18 包未按 Microsoft 官方方式安装，导致驱动文件未被 odbcinst.ini 识别，或系统根本未安装该驱动。
✅ 正确做法（适配 Ubuntu 22.04）如下：
1. 在 Dockerfile 中正确安装 msodbcsql18 和依赖
Microsoft 不直接将 msodbcsql18 发布到 Ubuntu 默认源，必须手动添加 Microsoft APT 仓库。请将以下关键步骤加入你的 Dockerfile（替换原 apt-get install 相关部分）：
# 添加 Microsoft GPG 密钥和 APT 源（Ubuntu 22.04）
RUN curl -fsSL https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor -o /usr/share/keyrings/microsoft-archive-keyring.gpg && \
echo "deb [arch=amd64,arm64,armhf signed-by=/usr/share/keyrings/microsoft-archive-keyring.gpg] https://packages.microsoft.com/config/ubuntu/22.04/prod.list" | tee /etc/apt/sources.list.d/mssql-release.list
# 更新源并安装驱动（注意：使用 msodbcsql18，非 msodbcsql17）
RUN apt-get update && \
ACCEPT_EULA=Y apt-get install -y \
msodbcsql18 \
mssql-tools18 \
unixodbc-dev \
&& rm -rf /var/lib/apt/lists/*
# 可选：验证驱动是否注册成功（构建时调试用）
RUN odbcinst -j && odbcinst -j | grep "Driver.*file" && \
echo "=== Available ODBC drivers ===" && \
odbcinst -j | grep "Driver.*file" | xargs dirname | xargs ls -l⚠️ 注意事项：ACCEPT_EULA=Y 是强制要求，否则安装会交互中断；mssql-tools18 包含 sqlcmd/bcp，虽非连接必需，但便于调试（如 sqlcmd -S -U -P ）；不要安装 unixodbc-dev 两次（原 Dockerfile 已有），避免冲突；msodbcsql17 在 Ubuntu 22.04 上已不再维护且不可用，务必使用 msodbcsql18。
2. 配置 SQLAlchemy 连接字符串（推荐使用标准驱动名）
修改你的 application-docker.cfg，将 DRIVER 替换为 Microsoft 官方注册的驱动名称（区分大小写）：
DRIVER = ODBC Driver 18 for SQL Server SERVER = your-sql-server-host DB_NAME = your_database USER_ID = your_username PSW = your_password
✅ 验证驱动名是否有效：容器启动后执行
docker exec -itbash -c "odbcinst -j | grep 'Driver.*file' | xargs dirname | xargs cat" 输出中应包含类似：
[ODBC Driver 18 for SQL Server] Description=Microsoft ODBC Driver 18 for SQL Server Driver=/opt/microsoft/msodbcsql18/lib64/libmsodbcsql-18.3.so.1.1
3. Python 连接示例（SQLAlchemy + pyodbc）
确保 requirements.txt 包含：
pyodbc>=4.0.39 SQLAlchemy>=1.4.0
连接代码建议使用 DSN-less 连接字符串（更可控）：
from sqlalchemy import create_engine
import urllib
params = urllib.parse.quote_plus(
"DRIVER={ODBC Driver 18 for SQL Server};"
f"SERVER={config.SERVER};"
f"DATABASE={config.DB_NAME};"
f"UID={config.USER_ID};"
f"PWD={config.PSW};"
"Encrypt=yes;"
"TrustServerCertificate=no;"
"Connection Timeout=30;"
)
engine = create_engine(f"mssql+pyodbc:///?odbc_connect={params}")? 安全提示：生产环境建议启用 Encrypt=yes 并配置可信证书（TrustServerCertificate=no），避免明文传输凭证。
总结
| 问题根源 | 解决方案 |
|---|---|
| DRIVER = 'SQL Server' 已废弃 | 改用 'ODBC Driver 18 for SQL Server' |
| msodbcsql17 在 Ubuntu 22.04 不可用 | 必须通过 Microsoft 官方源安装 msodbcsql18 |
| APT 源未配置 → Unable to locate package | 手动添加 packages.microsoft.com 源并导入 GPG 密钥 |
| 驱动路径硬编码易出错 | 优先使用注册名（如 ODBC Driver 18...），而非 .so 绝对路径 |
完成上述配置后，重建镜像并运行容器，即可稳定连接远程或本地 SQL Server 实例。如仍报错，请进入容器执行 odbcinst -j 和 cat /etc/odbcinst.ini 确认驱动注册状态。
