基于Alpine Docker镜像的Python连接Azure SQL失败求助

你遇到的错误核心原因很明确：unixODBC-dev只是ODBC驱动管理器的开发依赖，并不是针对SQL Server的专用驱动。要连接Azure SQL，你确实需要安装微软官方为Alpine编译的SQL Server ODBC驱动。

下面是具体的解决步骤，我会帮你修改Dockerfile并解释关键细节：

1. 添加微软Alpine软件源 #

微软官方为Alpine提供了包含SQL Server驱动的软件源，首先需要在镜像中添加这个源并信任其GPG密钥：

# 添加微软GPG密钥和软件源
RUN apk add --no-cache curl && \
    curl https://packages.microsoft.com/keys/microsoft.asc | apk add --no-cache --virtual .tmp-gpg-deps gnupg && \
    gpg --import - && \
    curl https://packages.microsoft.com/config/alpine/3.8/prod.repo > /etc/apk/repositories.d/microsoft-prod.repo && \
    apk del .tmp-gpg-deps

注意：这里的3.8对应你使用的alpine3.8，如果后续升级Alpine版本，需要同步修改源路径中的版本号。

2. 安装SQL Server ODBC驱动 #

添加源后，就可以安装官方驱动msodbcsql17（对应你代码中使用的ODBC Driver 17 for SQL Server），同时保留必要的编译依赖：

# 替换你原来的apk add命令，添加SQL Server驱动
RUN apk update && \
    apk add gcc libc-dev g++ libffi-dev libxml2 unixodbc-dev msodbcsql17

• msodbcsql17：微软官方的SQL Server ODBC驱动，正是你代码中指定的驱动文件
• 保留原有的编译依赖是为了确保pyodbc能正常编译安装

3. 验证驱动安装（可选） #

可以在Dockerfile中添加一行验证命令，确认驱动已被系统识别：

# 验证ODBC驱动是否安装成功
RUN odbcinst -j

运行镜像时，这会输出系统的ODBC配置信息，其中应该包含ODBC Driver 17 for SQL Server的条目。

修改后的完整Dockerfile #

整合以上步骤，你的Dockerfile应该变成这样：

FROM tiangolo/uwsgi-nginx:python3.7-alpine3.8

# 添加微软GPG密钥和软件源
RUN apk add --no-cache curl && \
    curl https://packages.microsoft.com/keys/microsoft.asc | apk add --no-cache --virtual .tmp-gpg-deps gnupg && \
    gpg --import - && \
    curl https://packages.microsoft.com/config/alpine/3.8/prod.repo > /etc/apk/repositories.d/microsoft-prod.repo && \
    apk del .tmp-gpg-deps

# 安装依赖和SQL Server ODBC驱动
RUN apk update && \
    apk add gcc libc-dev g++ libffi-dev libxml2 unixodbc-dev msodbcsql17

LABEL Name=code9 Version=0.0.1
EXPOSE 8000
ENV LISTEN_PORT=8000
ENV UWSGI_INI uwsgi.ini
WORKDIR /app
ADD . /app
RUN chmod g+w /app
RUN chmod g+w /app/db.sqlite3
RUN python3 -m pip install -r requirements.txt

额外注意事项 #

• 确保你的requirements.txt中包含pyodbc，否则Python无法调用ODBC驱动
• 如果需要使用sqlcmd等命令行工具，可以额外安装mssql-tools包（在apk add中添加即可）
• Alpine使用的是musl libc，微软的驱动已经针对musl编译，无需额外处理兼容性问题

完成以上修改后，重新构建镜像并运行你的Python代码，应该就能成功连接Azure SQL了。

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