继成功部署 Apache Superset 之后，我们深入到了 Python 开发容器的日常使用中。本文记录了为 FastAPI 项目配置 SQL Server 数据库驱动（ODBC）的全过程，是一份实用的“排坑”记录。
缘起：从 Superset 到 Python 开发容器
在上一篇文章中，我们成功地在 Windows 上通过 Docker 部署了 Apache Superset。这次，我将目光转向了一个新的 FastAPI 项目，它需要连接到 SQL Server 数据库。我决定将开发环境迁移到 VS Code 的开发容器（Dev Container） 中，以获得一个干净、隔离且可复现的开发环境。
然而，在容器中运行项目时，我遇到了第一个拦路虎：
ImportError: libodbc.so.2: cannot open shared object file: No such file or directory
这标志着一段深入理解容器、Python 依赖和数据库驱动兼容性的旅程开始了。
第一部分：初探容器内的 Python 环境
配置开发容器
我的项目使用 devcontainer.json 来定义开发环境，这是一个非常轻量的配置：
{ "name": "Python Dev Container", "image": "mcr.microsoft.com/devcontainers/python:3.1-3.14-bookworm", "customizations": { "vscode": { "extensions": ["ms-python.python", "ms-python.vscode-pylance"], "settings": { "python.defaultInterpreterPath": "/usr/local/bin/python" } } }, "postCreateCommand": "pip install --user -r requirements.txt", "forwardPorts": [5000]}
问题出现：libodbc.so.2 缺失
当我在容器终端中运行应用时，pyodbc 模块导入失败，提示找不到 libodbc.so.2 这个系统库。
这是什么意思？pyodbc 是一个 Python 包，它通过一个 C 语言扩展来调用操作系统的 ODBC 驱动管理器（unixODBC）。libodbc.so.2 就是这个驱动管理器的核心库文件。我当前的容器是一个精简的 Linux 系统，它没有预装这个库。
解决方案：安装 unixODBC在容器终端中执行：
sudo apt-get update && sudo apt-get install -y unixodbc unixodbc-dev
这个命令会从 Debian 软件源安装驱动管理器及其开发文件。
第二部分：解决容器网络与软件源问题
事情并没有这么简单。我在执行 apt-get update 时，卡在了 0% [Waiting for headers]，这意味着容器无法顺利访问默认的 Debian 官方软件源。
诊断：网络与 DNS
这在容器环境中很常见，尤其是在国内访问国际源时。我们需要：
更换为国内镜像源：提高下载速度和稳定性。
检查容器 DNS 配置：确保容器能够解析域名。
解决方案：换源与持久化配置
我首先在容器内临时修改了软件源：
# 备份原列表sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak# 替换为清华镜像源sudo sh -c 'echo "deb https://mirrors.tuna.tsinghua.edu.cn/debian/ bookworm main contrib non-free non-free-firmware" > /etc/apt/sources.list && echo "deb https://mirrors.tuna.tsinghua.edu.cn/debian/ bookworm-updates main contrib non-free non-free-firmware" >> /etc/apt/sources.list && echo "deb https://mirrors.tuna.tsinghua.edu.cn/debian-security bookworm-security main contrib non-free non-free-firmware" >> /etc/apt/sources.list'
关键一步：将配置永久化为了让每次重建容器时都自动配置好国内源，我把它写入了 devcontainer.json 的 postCreateCommand 中，并用 && 将多条命令连接起来，确保它们按顺序执行。
第三部分：挑战 SQL Server 专用驱动
安装 unixODBC 后，pyodbc 可以加载了，但新的错误出现了：
Can't open lib 'ODBC Driver 18 for SQL Server' : file not found
unixODBC 只是一个“驱动管理器”（可以理解为“翻译框架”），它还需要具体的“驱动程序”（“翻译员”）才能与 SQL Server 通信。我缺少的是微软官方的 ODBC Driver 18 for SQL Server。
在 Linux 容器中安装微软 ODBC 驱动
微软提供了适用于 Linux 的 ODBC 驱动，但安装步骤稍显复杂，因为需要添加微软的软件源并导入 GPG 密钥。
完整的安装脚本如下（已解决 apt-key 命令在新系统上被弃用的问题）：
# 1. 安装必要工具sudo apt-get install -y gnupg curl# 2. 下载并安装微软 GPG 密钥（新方法）curl -fsSL https://packages.microsoft.com/keys/microsoft.asc | sudo gpg --dearmor -o /usr/share/keyrings/microsoft-prod.gpg# 3. 添加微软软件源（适用于 Debian 12）echo 'deb [arch=amd64 signed-by=/usr/share/keyrings/microsoft-prod.gpg] https://packages.microsoft.com/debian/12/prod bookworm main' | sudo tee /etc/apt/sources.list.d/mssql-release.list# 4. 更新源并安装驱动（自动接受许可）sudo apt-get updatesudo ACCEPT_EULA=Y apt-get install -y msodbcsql18
关键更新：较新的 Debian/Ubuntu 系统不再支持 apt-key 命令，因此需要使用 gpg --dearmor 将下载的密钥转换为二进制格式，并在 sources.list 中通过 signed-by 参数指定它。这是一个更安全、更现代的做法。
最终 postCreateCommand 的完整形态
最终，我将所有必需的步骤整合到了 devcontainer.json 中，形成了一条强大的自动初始化命令：
"postCreateCommand": "sudo apt-get update && sudo apt-get install -y gnupg curl && curl -fsSL https://packages.microsoft.com/keys/microsoft.asc | sudo gpg --dearmor -o /usr/share/keyrings/microsoft-prod.gpg && echo 'deb [arch=amd64 signed-by=/usr/share/keyrings/microsoft-prod.gpg] https://packages.microsoft.com/debian/12/prod bookworm main' | sudo tee /etc/apt/sources.list.d/mssql-release.list && sudo apt-get update && sudo ACCEPT_EULA=Y apt-get install -y msodbcsql18 unixodbc unixodbc-dev && pip install --user -r requirements.txt"
这条命令在容器创建后会自动完成：更新源、安装工具、添加微软源、安装所有必需的系统库和 Python 依赖。
第四部分：知识巩固与常见问题
apt-get update 到底在做什么？
很多初学者会混淆 update 和 upgrade：
在执行 install 之前，先 update 是一个好习惯，能确保你安装的是最新版本。
如何查看当前连接的是哪个容器？
在 VS Code 中：
为什么有两个独立的容器？
当你从不同位置（如 Windows 本地路径和 WSL 路径）打开项目并“在容器中重新打开”时，VS Code 会为它们创建独立的容器。它们共享镜像层（所以不会重复下载大文件），但容器本身是隔离的，数据卷和安装的软件也互不影响。通过修改 devcontainer.json 中的 image 字段指向同一个镜像，可以让不同项目复用已配置好的环境。
结语：理解环境，方能驾驭环境
这次经历让我对开发容器的“隔离性”有了更深的体会。它既带来了干净的环境，也要求我们理解应用所依赖的底层系统库（如 ODBC 驱动）。
从解决 libodbc.so.2 缺失，到配置国内镜像源，再到安装微软官方驱动，每一步都加深了我对 Linux 系统、Docker 容器和 Python 生态整合的理解。最终，我们不仅解决了项目问题，还将所有知识固化在了 devcontainer.json 的配置中，实现了开发环境的“代码化”和“自动化”。
这份配置现在可以作为一个模板，为未来所有需要连接 SQL Server 的 Python 项目提供开箱即用的开发环境。
本文基于实际项目实践记录整理，环境为 Windows 11 + WSL 2 + Docker Desktop，Python 开发容器基于 python:3.14-bookworm 镜像。
10个月宝宝每天需要喝多少奶粉？
