基于Docker Compose自定义Airflow镜像遇`airflow db init`错误求助

问题出在你Dockerfile中的pip install命令重复安装了Airflow本身，官方镜像已经预装了对应版本的Airflow，重复安装会破坏镜像内的初始化配置或文件权限，导致数据库初始化检测异常。

修复步骤： #

1. 修改Dockerfile的pip安装命令：移除"apache-airflow==${AIRFLOW_VERSION}"部分，仅安装requirements.txt中的依赖：

FROM apache/airflow:2.8.1-python3.10

USER root
RUN apt-get update \
  && apt-get install -y --no-install-recommends \
         vim \
  && apt-get autoremove -yqq --purge \
  && apt-get clean \
  && rm -rf /var/lib/apt/lists/*
USER airflow

COPY requirements.txt /
RUN pip install --no-cache-dir -r /requirements.txt

2. 清理旧容器与缓存：避免残留的旧镜像/卷干扰：

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

3. 检查requirements.txt：确保其中没有指定与2.8.1版本冲突的Airflow包或依赖版本，所有依赖需兼容Airflow 2.8.1。

原理说明 #

官方Airflow镜像已经完成了基础环境配置、权限设置和Airflow核心组件安装，重复安装Airflow会覆盖这些预设配置，导致初始化脚本无法识别已有的数据库初始化状态，从而抛出错误。仅安装自定义依赖即可保留官方镜像的正常初始化流程。

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