如何连接本地Astronomer Airflow与PostgreSQL及启用连接测试

一、修复PostgreSQL连接拒绝错误 #

• 调整PostgreSQL监听配置
  找到本地PostgreSQL的postgresql.conf文件（Linux通常在/var/lib/postgresql/<版本>/main/，Windows在Program Files/PostgreSQL/<版本>/data/），修改listen_addresses为'*'，保存后重启PostgreSQL服务。
• 更新PostgreSQL访问控制规则
  打开同目录下的pg_hba.conf，添加允许Docker子网访问的规则：

  host    all             all             172.17.0.0/16          scram-sha-256
  

  172.17.0.0/16是Docker默认网桥子网，若用了自定义子网，替换成对应网段，之后重启PostgreSQL。
• 用宿主机真实IP作为连接地址
  放弃localhost或host.docker.localhost，直接填宿主机的局域网IP（比如192.168.3.10），Astro容器在Docker网络内，无法通过localhost直接映射到宿主机服务。
• 容器内验证连接
  进入Airflow容器执行命令测试连通性：

  astro dev bash
  psql -h 你的宿主机IP -p 5432 -U 数据库用户名 -d 目标数据库名
  

  能成功连接就说明网络问题已解决。

二、修复Airflow管理面板连接测试功能无效 #

• 确保配置放在正确小节
  修改airflow.cfg时，必须把test_connection = Enabled放在[core]小节下：

  [core]
  # 其他配置...
  test_connection = Enabled
  

• 用Astro CLI重启服务
  不要直接Docker重启容器，用Astro命令重新加载配置：

  astro dev restart
  

  这会确保所有Airflow组件（Webserver、Scheduler等）同步新配置。
• 验证配置是否生效
  进入Webserver容器检查配置：

  astro dev bash -w
  grep "test_connection" airflow.cfg
  

  输出显示test_connection = Enabled就说明配置已同步。
• 刷新Web界面缓存
  清除浏览器缓存或用无痕模式打开Airflow管理面板，再尝试测试连接。

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