Windows环境使用Airflow DockerOperator及报错解决方法

该报错触发的核心逻辑是运行Airflow的容器无法访问宿主机Docker Daemon的通信套接字。Airflow官方提供的默认Docker Compose部署配置仅适配Linux环境，默认挂载的/var/run/docker.sock路径在Windows环境下不存在，直接启动就会抛出文件找不到的连接异常。

• 前置检查：确认Docker Desktop运行状态
  打开Docker Desktop，确认左下角引擎状态为运行中，引擎后端必须选择WSL2（不推荐WSL1、旧版Hyper-V后端）：在设置-通用页勾选使用基于WSL2的引擎，如果你的Airflow部署在某个WSL发行版内，还要进入设置-资源-WSL集成页，给对应发行版开启集成权限，重启Docker Desktop生效。
• 修正套接字挂载配置
  打开Airflow部署目录下的docker-compose.yaml，找到所有服务（scheduler、worker、triggerer，用到DockerOperator的服务都要改）的volumes配置段，把默认的Linux套接字挂载规则替换成Windows适配版本：
  原默认配置：

  - /var/run/docker.sock:/var/run/docker.sock
  

  如果你用WSL2后端，替换为：

  - /mnt/wsl/docker-desktop/docker.sock:/var/run/docker.sock
  

  如果你用Hyper-V原生Windows容器后端，替换为：

  - //var/run/docker.sock:/var/run/docker.sock
  

  同时在对应服务的environment段添加Docker主机配置：

  environment:
    - DOCKER_HOST=unix:///var/run/docker.sock
  

• 修复容器内权限问题
  配置修改后执行docker compose down && docker compose up -d重启全栈服务，进入scheduler/worker容器内部执行docker ps验证连通性：
  • 如果返回权限拒绝错误，临时进入容器执行usermod -aG docker airflow将airflow用户加入docker用户组，要永久生效可以在服务配置中添加启动命令自动执行该授权，或者临时将服务运行用户设为root验证功能。
  • 如果正常返回容器列表，说明套接字通信已经打通。
• 功能验证
  编写最小测试DAG，调用DockerOperator运行官方hello-world镜像，不需要手动指定docker_url参数，保持默认即可，触发DAG确认任务能正常拉取镜像、执行容器、输出运行日志，没有连接报错。

• 不要轻易开启Docker Desktop的2375无认证TCP端口来解决连接问题，该方式会将Docker引擎直接暴露在网络上，存在极高的安全风险，优先使用Unix套接字挂载方案。
• WSL2环境下不要在WSL发行版内部单独安装Docker Engine，会和Docker Desktop提供的Daemon产生套接字冲突，直接使用Docker Desktop映射到WSL内的套接字文件即可。
• 所有配置修改后必须全量重启Compose栈，单独重启单个服务可能导致挂载规则不生效。

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