Apache Airflow创建用户失败报错：无法解析postgres主机名

• 检查PostgreSQL服务的网络可达性
  该错误核心是Airflow无法解析"postgres"主机名。本地部署时，可将Airflow配置中sql_alchemy_conn的主机名从"postgres"替换为"localhost"或PostgreSQL服务的实际IP地址；容器部署场景下，需确保Airflow与PostgreSQL处于同一网络环境。

• 验证Airflow数据库连接配置
  打开Airflow的airflow.cfg配置文件，定位到sql_alchemy_conn项，确认连接字符串格式正确：postgresql+psycopg2://<用户名>:<密码>@<主机地址>:<端口>/<数据库名>，其中<主机地址>需替换为可被正确解析的地址（如127.0.0.1、服务器公网IP等）。

• 配置本地主机名映射
  若需保留"postgres"作为主机名，可在Airflow所在机器的hosts文件中添加映射：

  • Linux/macOS：编辑/etc/hosts，添加[PostgreSQL服务器IP] postgres
  • Windows：编辑C:\Windows\System32\drivers\etc\hosts，添加相同映射内容
    保存后系统即可解析该主机名。

• Docker环境的专属检查
  若使用Docker Compose部署，需确认：

  • Airflow与PostgreSQL服务配置了相同的networks（可在docker-compose.yml中查看）
  • PostgreSQL服务的名称确实为"postgres"（Docker容器间可通过服务名作为主机名访问，若服务名不同需同步修改Airflow配置中的主机名）

• 确认PostgreSQL服务状态
  先排查PostgreSQL服务是否正常运行：

  • Linux系统：执行systemctl status postgresql查看服务状态
  • Docker环境：执行docker ps确认PostgreSQL容器处于运行状态，且端口映射正确

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