在Amazon EKS集群配置Airflow连接RDS PostgreSQL时遇初始化错误

问题核心原因 #

你遇到的问题是由于该Airflow Helm Chart默认启用了Pgbouncer连接池组件，即便配置了外部RDS数据库，Airflow的数据库连接仍会被指向集群内的Pgbouncer Service，而非直接连接RDS。

解决步骤 #

• 禁用内置Pgbouncer
  在你的Helm values配置中添加以下设置，彻底关闭Pgbouncer组件：

  pgbouncer:
    enabled: false
  

• 正确配置外部RDS并禁用嵌入式PostgreSQL
  确保values.yaml中正确配置外部数据库参数，同时关闭内置PostgreSQL：

  # 禁用嵌入式PostgreSQL
  postgresql:
    enabled: false
  
  # 配置外部RDS
  externalDatabase:
    type: postgres
    host: <你的RDS实例端点>
    port: 5432
    database: <RDS中创建的Airflow数据库名>
    user: <RDS数据库用户名>
    password: <RDS数据库密码>
    # 若RDS要求SSL连接，添加SSL配置
    sslMode: require
  

• 验证配置渲染结果
  部署前用helm template命令渲染模板，检查初始化容器的环境变量AIRFLOW__DATABASE__SQL_ALCHEMY_CONN，确认其值为RDS的连接字符串，而非Pgbouncer的Service地址：

  helm template airflow airflow-helm/airflow -f your-values.yaml | grep -A 5 -B 5 "AIRFLOW__DATABASE__SQL_ALCHEMY_CONN"
  

• 清理残留资源（可选）
  如果之前部署过带Pgbouncer的版本，可能存在残留的ConfigMap/Secret导致配置未生效，先卸载旧版本再重新部署：

  helm uninstall airflow -n airflow-cluster
  kubectl delete configmap,secret -n airflow-cluster -l app.kubernetes.io/instance=airflow
  

补充说明 #

当使用嵌入式PostgreSQL时，Pgbouncer会正确指向内置DB，所以应用能正常运行；但切换到外部RDS时，必须禁用Pgbouncer，否则Airflow会继续通过Pgbouncer中转，而Pgbouncer默认配置是连接内置DB，最终导致连接错误。

内容的提问来源于stack exchange，提问作者Siva muthu Kumaran