构建Docker镜像失败：安装pymssql时出现sqlfront.h缺失错误

错误原因 #

构建镜像时pymssql编译失败，核心是缺少FreeTDS开发依赖库——pymssql底层依赖FreeTDS实现SQL Server连接，编译过程需要它的头文件（比如sqlfront.h），但官方Python镜像默认未安装该库，导致gcc编译报错。

另外你的requirements.txt存在两个无效依赖：

• jsonify不是独立包，它是Flask的内置模块，无需单独安装
• jwt是无效包名，实际需要的是pyjwt

修正方案 #

1. 修改Dockerfile，添加系统依赖 #

在执行pip install前，先安装FreeTDS开发包和gcc（编译必需工具）：

FROM python:3.10

# 安装pymssql编译依赖
RUN apt-get update && apt-get install -y --no-install-recommends \
    freetds-dev \
    gcc \
    && rm -rf /var/lib/apt/lists/*

COPY ./requirements.txt /app/requirements.txt
WORKDIR /app
RUN pip install --upgrade pip && pip install -r requirements.txt
COPY . /app
EXPOSE 8081

CMD ["python", "app.py"]

• --no-install-recommends减少镜像体积，避免安装不必要的依赖
• 清理apt缓存进一步缩小镜像大小
• 先升级pip，规避旧版本pip的兼容性问题

2. 修正requirements.txt #

移除无效包，替换错误包名：

flask
pandas
pymssql
numpy
pyjwt

验证步骤 #

1. 用修改后的文件重新构建镜像：docker build -t flask-app .
2. 本地运行测试：docker run -p 8081:8081 flask-app，确认应用能正常启动并连接SQL Server
3. 推送镜像到AWS App Runner完成部署

内容的提问来源于stack exchange，提问作者Ahmet Buğra BUĞA