基于Docker Alpine部署Django连接MSSQL时pyodbc依赖安装失败求助

核心问题分析 #

报错提示找不到libodbc.so.2，是因为Alpine镜像中仅安装了编译用的unixodbc-dev包，缺少运行时依赖的unixodbc包；同时pip install --user会导致依赖安装路径异常，容器运行时无法被Django/uWSGI识别。

修复后的完整配置 #

Dockerfile

FROM python:3.8-alpine

COPY ./requirements.txt /requirements.txt
COPY ./entrypoint.sh /entrypoint.sh

# 安装系统依赖+编译+清理，合并命令减少镜像体积
RUN apk update && \
    apk add --no-cache python3-dev gcc g++ linux-headers unixodbc unixodbc-dev && \
    python3 -m ensurepip && \
    pip3 install pyodbc --no-binary pyodbc && \
    pip3 install -r /requirements.txt && \
    # 清理编译用的冗余依赖
    apk del python3-dev gcc g++ linux-headers unixodbc-dev && \
    # 给启动脚本添加执行权限
    chmod +x /entrypoint.sh

CMD ["/entrypoint.sh"]

关键修复点

• 补充运行时依赖：新增unixodbc包，提供pyodbc运行必需的libodbc.so.2共享库
• 移除--user参数：全局安装Python依赖，避免路径识别问题
• 优化镜像构建：合并RUN命令、清理编译依赖，缩小镜像体积
• 添加脚本权限：确保entrypoint.sh可被容器执行

验证步骤 #

重新构建镜像并启动容器，Django应用将能正常加载pyodbc模块，建立与MSSQL服务器的连接。

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