构建Docker镜像时Poetry报连接池已满错误如何解决？

问题原因 #

容器环境的网络栈与本地主机存在差异，Poetry默认的连接池大小（10）在Docker环境下无法支撑并发依赖下载的需求，导致连接被丢弃。本地环境网络条件更稳定，因此不会触发该问题。

解决方案 #

1. 增大Poetry连接池大小

可以通过两种方式调整连接池上限：

• 方式一：通过环境变量设置
  在Dockerfile的poetry阶段新增环境变量，修改后的Dockerfile如下：

FROM python:3.10-alpine AS python
ENV PYTHONUNBUFFERED=true
WORKDIR /app

FROM python as poetry
ENV POETRY_HOME=/opt/poetry
ENV POETRY_VIRTUALENVS_IN_PROJECT=true
ENV POETRY_HTTP_POOL_SIZE=20  # 新增：将连接池大小调整为20
ENV PATH="$POETRY_HOME/bin:$PATH"
RUN python -c 'from urllib.request import urlopen; print(urlopen("https://install.python-poetry.org").read().decode())' | python -
COPY pyproject.toml poetry.lock ./
RUN poetry install --no-interaction --no-ansi -vvv

• 方式二：通过Poetry配置命令设置
  在执行poetry install前先配置连接池大小，修改对应RUN指令：

RUN poetry config http.pool-size 20 && poetry install --no-interaction --no-ansi -vvv

2. 优化网络与依赖下载效率

• 补充SSL证书依赖：Alpine镜像默认缺少部分SSL证书，可能导致连接建立延迟，间接加剧连接池压力。在安装Poetry前添加以下指令：

RUN apk add --no-cache ca-certificates

• 切换国内PyPI镜像源：使用国内镜像可减少网络延迟，降低并发连接需求，添加配置指令：

RUN poetry config repositories.pypi https://pypi.tuna.tsinghua.edu.cn/simple

3. 确保依赖文件一致性

确认本地的poetry.lock与Docker构建时使用的文件完全一致，避免Poetry在构建过程中重新解析依赖，产生额外的网络请求。

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