Docker部署Airflow修改默认配置后启动报错问题排查

核心排查与解决步骤 #

这个错误的本质是Airflow服务尝试连接的数据库名，和PostgreSQL容器实际创建的数据库名不匹配，按以下步骤逐一排查修复：

• 检查.env文件变量一致性
  打开你的.env文件，确认以下关键变量的取值和关联：

  • POSTGRES_DB: PostgreSQL容器启动时会自动创建的数据库名（比如设为airflow）
  • POSTGRES_USER: PostgreSQL的登录用户名（比如airflow_user）
  • POSTGRES_PASSWORD: 对应的登录密码
    同时确保AIRFLOW__DATABASE__SQL_ALCHEMY_CONN的格式完全正确：

  AIRFLOW__DATABASE__SQL_ALCHEMY_CONN=postgresql+psycopg2://${POSTGRES_USER}:${POSTGRES_PASSWORD}@postgres/${POSTGRES_DB}
  

  重点：末尾的${POSTGRES_DB}必须和上面的POSTGRES_DB变量值完全一致，不能误写为用户名或其他值。

• 验证docker-compose.yml中PostgreSQL服务配置
  找到postgres服务的environment配置块，确保它正确引用.env变量，没有硬编码的冲突值：

  services:
    postgres:
      image: postgres:13
      environment:
        POSTGRES_USER: ${POSTGRES_USER}
        POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
        POSTGRES_DB: ${POSTGRES_DB}
      volumes:
        - postgres-db-volume:/var/lib/postgresql/data
  

  注意：如果此处硬写了数据库名（比如POSTGRES_DB: user），会覆盖.env配置，导致创建的数据库和Airflow要连接的不一致。

• 彻底清理并重新初始化环境
  执行命令完全清理旧环境数据：

  docker-compose down --volumes --remove-orphans --rmi local
  

  重新执行Airflow初始化：

  docker-compose up airflow-init
  

  初始化完成后启动所有服务：

  docker-compose up -d
  

  可查看PostgreSQL日志确认数据库创建状态：

  docker logs <你的postgres容器名称>
  

  日志中应出现类似database "airflow" is ready to accept connections的提示。

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