Fly.io部署Django报错求助：镜像拉取/构建失败排查

一、错误原因排查 #

1. requirements.txt 问题 #

• 检查是否存在不存在的包名或版本冲突，比如某些包仅支持特定Python版本
• 确认是否包含需要编译的包（如psycopg2），这类包依赖系统级工具，改用psycopg2-binary可跳过编译环节
• 排查是否被.dockerignore误忽略，导致构建时无法读取该文件

2. Dockerfile 配置问题 #

• 原错误显示命令末尾为&&.，说明Dockerfile的构建命令不完整，遗漏了收集静态文件、启动服务等后续步骤
• 基础镜像优先选择python:X.X-slim而非alpine，alpine缺少大量编译依赖，极易导致pip安装失败
• 未提前安装系统级依赖：编译Python包需要build-essential、libpq-dev等工具，必须在pip安装前完成部署

3. 构建缓存问题 #

之前的失败构建缓存可能残留异常状态，导致后续部署重复触发相同报错

二、修正后的部署命令方案 #

• 强制清理缓存重新构建：

  flyctl deploy --no-cache
  

• 查看完整构建日志，定位具体报错细节：

  flyctl deploy --verbose
  

• 本地提前测试构建，避免远程部署踩坑：

  docker build -t django-fly-test .
  

• 若需保留现有资源重新初始化配置：

  flyctl launch --existing
  

三、关键配置文件修正示例 #

1. 正确的Dockerfile #

FROM python:3.11-slim

WORKDIR /app

# 安装系统依赖，解决编译类包的安装问题
RUN apt-get update && apt-get install -y --no-install-recommends \
    build-essential \
    libpq-dev \
    && rm -rf /var/lib/apt/lists/*

# 复制依赖文件并安装
COPY requirements.txt /tmp/requirements.txt
RUN set -ex && \
    pip install --upgrade pip && \
    pip install -r /tmp/requirements.txt

# 复制项目代码
COPY . .

# 收集静态文件（生产环境必须）
RUN python manage.py collectstatic --noinput

# 启动gunicorn服务
CMD ["gunicorn", "--bind", "0.0.0.0:8000", "你的项目名.wsgi:application"]

2. requirements.txt 生产环境模板 #

django>=4.2,<5.0
gunicorn==20.1.0
psycopg2-binary>=2.9.0
whitenoise>=6.6.0
# 其他你的项目依赖

注意：用pip freeze --exclude-editable > requirements.txt生成，不要包含pytest、django-debug-toolbar等开发依赖

3. fly.toml 核心配置 #

app = "你的应用名称"
primary_region = "你的目标区域（如hkg）"

[http_service]
  internal_port = 8000
  force_https = true
  auto_stop_machines = true
  auto_start_machines = true
  min_machines_running = 0

[env]
  DJANGO_SETTINGS_MODULE = "你的项目名.settings.production"
  SECRET_KEY = "你的Django密钥"
  # 若使用Fly.io Postgres，DATABASE_URL会自动注入，无需手动填写

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