Docker镜像构建遇RuntimeError: can't start new thread错误求助

问题原因 #

从错误栈可定位：pip 23.0.1使用rich库生成下载进度条时，尝试启动后台刷新线程失败。结合你的场景：

• 构建流程此前正常，近期突然失效，核心原因是python:3.8-slim基础镜像更新后，容器的线程资源限制更严格；
• pip默认启用的rich进度条依赖线程实现，在资源受限的slim镜像环境中无法创建新线程。

解决办法 #

1. 禁用pip进度条（最快生效） #

修改pip install命令，添加--no-progress-bar参数，避免触发线程创建逻辑：

RUN pip install --no-progress-bar poetry==1.5.1

也可通过环境变量全局禁用进度条：

ENV PIP_PROGRESS_BAR=off

2. 调整pip升级步骤顺序 #

你的Dockerfile中，COPY ./ .在pip install --upgrade pip之前，若项目目录包含pip配置或依赖文件，可能干扰升级效果。调整顺序，先升级pip再复制项目文件：

FROM python:3.8-slim
LABEL version="1.0"
ENV PIP_NO_CACHE_DIR=off\
    PYTHONUNBUFFERED=1\
    PYTHONDONTWRITEBYTECODE=1\
    POETRY_HOME="/opt/poetry"\
    POETRY_CACHE_DIR='/var/cache/pypoetry'\
    POETRY_NO_INTERACTION=1

WORKDIR /app
# 先升级pip，再复制项目文件
RUN pip install --upgrade pip
COPY ./ .
COPY --from=script_downloader /tmp/wait-for-it.sh .
RUN chmod +x wait-for-it.sh
RUN pip install poetry==1.5.1
RUN poetry install

3. 使用Poetry官方安装脚本 #

绕过pip直接安装Poetry，避免pip的线程问题：

# 替换原有的RUN pip install poetry==1.5.1
RUN curl -sSL https://install.python-poetry.org | python3 - --version 1.5.1
ENV PATH="$POETRY_HOME/bin:$PATH"

4. 切换至完整Python镜像（备选） #

若上述方法无效，可尝试使用非slim的python:3.8镜像，它的资源限制更宽松，但镜像体积会增大：

FROM python:3.8

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