FastAPI+PostgreSQL项目Docker构建失败，apt-clone依赖安装出错求解决

问题根源 #

报错提示找不到apt-clone==0.2.1，因为apt-clone是Debian/Ubuntu系统的系统工具，并非PyPI上的Python包，它不应该出现在requirements.txt中，大概率是执行pip freeze时误将系统环境中的非项目依赖写入了文件。

解决方案 #

1. 清理并修正requirements.txt #

打开requirements.txt，删除apt-clone==0.2.1这一行，只保留FastAPI项目及PostgreSQL相关的必要依赖。示例合理的依赖列表如下：

fastapi>=0.100.0
uvicorn>=0.23.2
sqlalchemy>=2.0.20
psycopg2-binary>=2.9.7
pydantic>=2.0.3

2. 优化Dockerfile配置 #

原Dockerfile存在COPY路径逻辑问题，且未启用pip升级，调整后如下：

FROM python:3.9
ENV PYTHONDONTWRITEBYTECODE 1
ENV PYTHONUNBUFFERED 1
WORKDIR /app

# 先复制requirements.txt，利用Docker缓存减少重复构建时间
COPY requirements.txt .
# 升级pip到最新版本
RUN python -m pip install --upgrade pip
# 安装依赖
RUN pip install -r requirements.txt

# 最后复制项目代码
COPY ./app ./app

• 调整COPY顺序：先处理依赖文件，可缓存依赖安装层，后续仅代码改动时无需重新安装依赖
• 启用pip升级：解决原构建中的pip版本警告，避免因旧版本pip导致的潜在安装问题

3. 重新构建运行项目 #

执行以下命令重新构建并启动服务：

docker-compose down
docker-compose build --no-cache
docker-compose up

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