Docker构建FastAPI项目时执行pip install poetry报错：无效ELF头

在Python FastAPI项目执行dev up构建Docker镜像时，执行Dockerfile中的RUN pip install poetry==1.1.13命令触发错误，核心报错提示：

ImportError: /lib/x86_64-linux-gnu/libexpat.so.1: invalid ELF header

Dockerfile内容 #

FROM python:3.10

WORKDIR /src
EXPOSE 8080

RUN apt-get update && apt-get install -y curl make && rm -rf /var/lib/apt/lists/*

RUN pip install poetry==1.1.13
RUN poetry config virtualenvs.create false
COPY poetry.lock /src/
COPY pyproject.toml /src/
RUN poetry export -f requirements.txt --without-hashes --output requirements.txt
RUN pip install -r requirements.txt

COPY . /src
RUN cd /src && python setup.py develop

RUN chmod +x /src/bin/run.sh

CMD ["/src/bin/run.sh"]

完整错误日志 #

# ERROR
#8 1.550 Traceback (most recent call last):
#8 1.550   File "/usr/local/bin/pip", line 8, in <module>
#8 1.550     sys.exit(main())
#8 1.550   File "/usr/local/lib/python3.10/site-packages/pip/_internal/cli/main.py", line 68, in main
#8 1.550     command = create_command(cmd_name, isolated=("--isolated" in cmd_args))
#8 1.550   File "/usr/local/lib/python3.10/site-packages/pip/_internal/commands/__init__.py", line 114, in create_command
#8 1.550     module = importlib.import_module(module_path)
#8 1.550   File "/usr/local/lib/python3.10/importlib/__init__.py", line 126, in import_module
#8 1.550     return _bootstrap._gcd_import(name[level:], package, level)
#8 1.550   File "<frozen importlib._bootstrap>", line 1050, in _gcd_import
#8 1.550   File "<frozen importlib._bootstrap>", line 1027, in _find_and_load
#8 1.551   File "<frozen importlib._bootstrap>", line 1006, in _find_and_load_unlocked
#8 1.551   File "<frozen importlib._bootstrap>", line 688, in _load_unlocked
#8 1.551   File "<frozen importlib._bootstrap_external>", line 883, in exec_module
#8 1.551   File "<frozen importlib._bootstrap>", line 241, in _call_with_frames_removed
#8 1.551   File "/usr/local/lib/python3.10/site-packages/pip/_internal/commands/install.py", line 16, in <module>
#8 1.551     from pip._internal.cli.req_command import (
#8 1.551   File "/usr/local/lib/python3.10/site-packages/pip/_internal/cli/req_command.py", line 21, in <module>
#8 1.551     from pip._internal.index.package_finder import PackageFinder
#8 1.551   File "/usr/local/lib/python3.10/site-packages/pip/_internal/index/package_finder.py", line 33, in <module>
#8 1.551     from pip._internal.req import InstallRequirement
#8 1.551   File "/usr/local/lib/python3.10/site-packages/pip/_internal/req/__init__.py", line 8, in <module>
#8 1.551     from .req_install import InstallRequirement
#8 1.551   File "/usr/local/lib/python3.10/site-packages/pip/_internal/req/req_install.py", line 44, in <module>
#8 1.551     from pip._internal.operations.install.wheel import install_wheel
#8 1.551   File "/usr/local/lib/python3.10/site-packages/pip/_internal/operations/install/wheel.py", line 39, in <module>
#8 1.551     from pip._vendor.distlib.scripts import ScriptMaker
#8 1.551   File "/usr/local/lib/python3.10/site-packages/pip/_vendor/distlib/scripts.py", line 16, in <module>
#8 1.552     from .compat import sysconfig, detect_encoding, ZipFile
#8 1.552   File "/usr/local/lib/python3.10/site-packages/pip/_vendor/distlib/compat.py", line 83, in <module>
#8 1.552     import xmlrpc.client as xmlrpclib
#8 1.552   File "/usr/local/lib/python3.10/xmlrpc/client.py", line 138, in <module>
#8 1.552     from xml.parsers import expat
#8 1.552   File "/usr/local/lib/python3.10/xml/parsers/expat.py", line 4, in <module>
#8 1.552     from pyexpat import *
#8 1.552 ImportError: /lib/x86_64-linux-gnu/libexpat.so.1: invalid ELF header
#8 ERROR: executor failed running [/bin/sh -c pip install poetry==1.1.13]: exit code: 1
------
 > [ 4/12] RUN pip install poetry==1.1.13:
------
executor failed running [/bin/sh -c pip install poetry==1.1.13]: exit code: 1
Cleaning up...
 - No resources found
build failed: exit status 1. Docker build ran into internal error. Please retry

解决方案 #

1. 修复损坏的libexpat.so.1库文件 #

该错误说明系统的libexpat.so.1库文件损坏或不兼容，在Dockerfile的apt-get install步骤中添加/重新安装该库：

RUN apt-get update && apt-get install -y curl make libexpat1 && rm -rf /var/lib/apt/lists/*

若仍有问题，强制重新安装：

RUN apt-get update && apt-get install -y --reinstall libexpat1 && rm -rf /var/lib/apt/lists/*

2. 更换Python基础镜像版本 #

特定Python镜像可能存在系统库兼容问题，尝试切换到更稳定的变体：

FROM python:3.10-slim-bullseye

或升级到Python 3.11稳定镜像，避开版本兼容坑。

3. 清理Docker构建缓存 #

本地缓存可能保留损坏的构建层，执行以下命令清理后重新构建：

docker builder prune -a

4. 改用官方推荐的poetry安装方式 #

避免用pip直接安装旧版本poetry，改用官方脚本安装兼容性更好：
替换原RUN pip install poetry==1.1.13为：

RUN curl -sSL https://install.python-poetry.org | python3 - --version 1.1.13
ENV PATH="/root/.local/bin:$PATH"

5. 排查本地挂载污染 #

若构建时使用了本地目录挂载，可能带入本地损坏的库文件，确保构建阶段无不必要的volume挂载，或通过.dockerignore排除无关文件。

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