Airflow WebUI创建连接时报错，已填写正确信息仍无法解决

云上老周

2026-9-26

Docker Compose 部署 Airflow 新建连接报错解决方案

你遇到的报错属于Docker部署场景下Airflow的常见网络连通性问题，可按以下步骤逐一排查解决：

修正数据库主机地址
Docker环境下的服务默认处于独立网桥中，无法直接用localhost/127.0.0.1访问宿主主机的服务：
- 如果目标数据库部署在宿主主机，Mac/Windows 环境可直接填写host.docker.internal作为主机地址，Linux 环境可填写宿主机在Docker网桥中的网关IP（通常为172.17.0.1，可执行ip addr show docker0查看）
- 如果目标数据库和Airflow同属一个docker-compose.yml管理，直接填写数据库服务的服务名作为主机地址即可

手动测试容器内连通性
进入Airflow scheduler容器，用命令行测试和数据库的连通性，确认网络、端口、账号是否正常：

# 查看Airflow scheduler容器名称
docker ps | grep scheduler
# 进入容器内部
docker exec -it <scheduler容器名> bash
# 测试端口连通性，替换为你实际的数据库主机和端口
nc -zv <数据库主机> <数据库端口>
# 也可以直接用对应数据库的客户端工具测试登录，比如PostgreSQL：
psql -h <数据库主机> -p <端口> -U <用户名> <数据库名>

检查连接附加配置
确认Airflow连接配置的Extra字段没有填写错误参数，如果你不需要SSL连接，可在Extra字段添加以下配置关闭SSL校验：
```
{"ssl": false}
```
确认数据库账号权限
检查你使用的数据库账号是否允许Airflow容器所在的IP段访问，比如MySQL默认的本地账号不允许远程IP登录，需要手动执行授权语句。