Docker部署Airflow无法连接PostgreSQL问题排查求助

1. 先查PostgreSQL健康检查失败根因 #

postgres容器标记为unhealthy是核心问题——Airflow所有服务都依赖数据库就绪，这直接导致其他容器卡在Created状态。

• 拉取postgres完整日志找报错：

  docker logs airflow-postgres
  

  重点看健康检查相关的失败信息，常见问题有：数据目录权限不足、残留锁文件（比如postmaster.pid）、数据库初始化未完成就触发检查。
• 手动进入容器验证健康检查命令：

  docker exec -it airflow-postgres bash
  # 执行默认健康检查命令（不同配置可能有差异）
  psql -U airflow -c "SELECT 1"
  

  执行失败的报错会直接告诉你问题，比如密码不匹配、用户不存在。

2. 彻底清理Docker残留数据 #

docker compose down可能没清干净数据卷，旧状态会干扰重启：

• 彻底删除所有关联容器、数据卷（注意：会清空postgres数据，需先备份挂载目录）：

  docker compose down -v --remove-orphans
  

• 清理Docker缓存释放资源：

  docker system prune -f
  

3. 检查EC2实例资源状态 #

• 用top或者AWS控制台看CPU、内存占用：资源不足会导致postgres初始化缓慢，健康检查超时。
• 用df -h查磁盘空间：磁盘满了会让postgres无法写入日志/数据，直接触发健康检查失败。

4. 校验docker-compose.yml关键配置 #

• 确认postgres健康检查参数是否合理，尤其是启动等待时间：

  services:
    postgres:
      healthcheck:
        test: ["CMD", "pg_isready", "-U", "airflow"]
        interval: 5s
        retries: 5
        start_period: 30s  # 这个值如果太小，postgres没初始化完就被判定不健康
  

• 确认Airflow服务的依赖配置是否绑定postgres健康状态：

  services:
    webserver:
      depends_on:
        postgres:
          condition: service_healthy
  

  没有这个配置的话，Airflow容器会在postgres没就绪时强行启动，直接卡壳。

5. 核对airflow.cfg数据库连接 #

确保配置里的数据库连接串和docker-compose.yml的postgres环境变量完全匹配：

sql_alchemy_conn = postgresql+psycopg2://airflow:airflow@postgres:5432/airflow

重点检查用户名、密码、数据库名、服务主机名是否一致。

6. 修复本地挂载目录权限（如果有挂载） #

如果postgres配置了本地目录挂载，比如：

postgres:
  volumes:
    - ./postgres_data:/var/lib/postgresql/data

EC2上默认目录权限是root，postgres进程（UID通常为999）没读写权限，执行修复：

sudo chown -R 999:999 ./postgres_data

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