首次运行docker compose up --build遇pywin32==306安装失败问题

报错信息 #

8.892 ERROR: Could not find a version that satisfies the requirement pywin32==306 (from versions: none)
8.893 ERROR: No matching distribution found for pywin32==306
------
failed to solve: process "/bin/sh -c pip install -r requirements.txt" did not complete successfully: exit code: 1

问题原因 #

pywin32是仅针对Windows系统开发的Python库，用于调用Windows系统API。你当前使用的Docker基础镜像是python:3，默认基于Linux系统，pip在Linux环境下无法找到该库的适配版本，因此报错。而本地Windows环境能正常安装，是因为系统平台匹配。

解决方案 #

方案1：移除不必要的依赖 #

直接从requirements.txt中删除pywin32==306这一行，因为Linux容器中根本不需要这个库。修改后的requirements.txt如下：

asgiref==3.7.2
backports.zoneinfo==0.2.1
certifi==2024.2.2
charset-normalizer==3.3.2
Django==4.2.11
docker==7.0.0
idna==3.6
packaging==24.0
requests==2.31.0
sqlparse==0.4.4
typing_extensions==4.10.0
tzdata==2024.1
urllib3==2.2.1

方案2：添加平台条件依赖（兼容本地Windows和Docker Linux） #

如果本地Windows开发需要保留pywin32，可以给依赖添加系统平台标记，让pip自动根据环境判断是否安装：

asgiref==3.7.2
backports.zoneinfo==0.2.1
certifi==2024.2.2
charset-normalizer==3.3.2
Django==4.2.11
docker==7.0.0
idna==3.6
packaging==24.0
requests==2.31.0
sqlparse==0.4.4
typing_extensions==4.10.0
tzdata==2024.1
urllib3==2.2.1
# 仅Windows环境安装pywin32
pywin32==306; sys_platform == 'win32'

方案3：改用Windows Docker镜像（不推荐） #

如果你的应用确实依赖Windows系统特性，必须使用pywin32，可以修改Dockerfile使用Windows基础镜像：

FROM python:3-windowsservercore

ENV PYTHONUNBUFFERED=1

WORKDIR /code

COPY requirements.txt .

RUN pip install -r requirements.txt

COPY . .

EXPOSE 8000

CMD ["python","manage.py","runserver"]

注意：Windows Docker镜像体积远大于Linux镜像，且兼容性有限，仅在必要时使用。

你的原始配置 #

Dockerfile #

FROM python:3

ENV PYTHONUNBUFFERED=1

WORKDIR /code

COPY requirements.txt .

RUN pip install -r requirements.txt

COPY . .

EXPOSE 8000

CMD ["python","manage.py","runserver"]

原始requirements.txt #

asgiref==3.7.2
backports.zoneinfo==0.2.1
certifi==2024.2.2
charset-normalizer==3.3.2
Django==4.2.11
docker==7.0.0
idna==3.6
packaging==24.0
pywin32==306
requests==2.31.0
sqlparse==0.4.4
typing_extensions==4.10.0
tzdata==2024.1
urllib3==2.2.1

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