Docker构建镜像过程中无法安装PIP与PYMSSQL问题求助

错误原因 #

本次构建失败有3个核心问题：

• pymssql编译依赖FreeTDS相关库，当前Dockerfile未安装freetds-dev、libssl-dev依赖包，导致pip安装过程中编译失败
• 最新版Ubuntu官方软件源已经移除Python2.7相关软件包，且python2.7.x本身是无效的包名，会直接触发安装报错
• ENTRYPOINT使用了单引号，不符合Dockerfile Exec模式的双引号语法要求，即使前面的步骤构建成功，容器启动也会报错

修复方案 #

方案1：使用Python3（更推荐，长期维护支持） #

直接使用官方预制的Python基础镜像，稳定性更高、镜像体积更小，Dockerfile内容如下：

FROM python:3.9-slim

RUN apt-get update && apt-get install -y --no-install-recommends \
    telnet \
    ksh \
    freetds-dev \
    gcc \
    build-essential \
    && apt-get clean \
    && rm -rf /var/lib/apt/lists/*

RUN pip install --no-cache-dir pymssql==2.2.7

ENTRYPOINT ["python"]

方案2：兼容Python2.7 + pymssql 2.1.3 #

如果业务必须使用指定的Python2和pymssql版本，使用带Python2软件源的旧版Ubuntu作为基础镜像，Dockerfile内容如下：

FROM ubuntu:18.04

RUN apt-get update && apt-get install -y --no-install-recommends \
    telnet \
    ksh \
    python2.7 \
    python-pip \
    python-dev \
    build-essential \
    freetds-dev \
    libssl-dev \
    && apt-get clean \
    && rm -rf /var/lib/apt/lists/*

RUN pip install pymssql==2.1.3

ENTRYPOINT ["python"]

关键修改说明 #

• 基础镜像调整：Python3方案直接使用官方Python镜像，避免手动安装Python的各类适配问题；Python2方案使用Ubuntu 18.04，确保软件源包含Python2相关安装包
• 新增pymssql编译依赖：补充freetds-dev、libssl-dev包，满足pymssql编译要求
• 修正无效包名：将错误的python2.7.x修改为合法包名python2.7
• 修正ENTRYPOINT语法：将单引号替换为Docker要求的双引号
• 镜像体积优化：合并RUN命令减少镜像层数，添加--no-install-recommends参数避免安装无关依赖，构建完成后清理apt缓存进一步缩小体积

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