WSL环境安装Airflow后无法访问localhost:8080且scheduler启动过慢咨询

WSL环境Airflow异常问题解决方案 #

问题1：webserver运行正常但无法通过localhost:8080访问 #

• 首先修改Airflow配置文件airflow.cfg中的web_server_host参数，将默认值127.0.0.1改为0.0.0.0，使服务监听所有网卡请求，修改后重启webserver服务
• 在WSL终端执行hostname -I获取WSL实例的虚拟IP，使用[WSL虚拟IP]:8080的格式访问服务
• 如需长期使用localhost访问，可在Windows管理员权限CMD中执行端口转发命令：netsh interface portproxy add v4tov4 listenport=8080 listenaddress=0.0.0.0 connectport=8080 connectaddress=替换为你的WSL虚拟IP
  相关异常截图：
  

问题2：scheduler命令启动后长时间无响应 #

• 优先排查元数据库配置：默认使用的SQLite数据库不支持并行读写，极易导致scheduler调度卡住，建议替换为MySQL或PostgreSQL，修改airflow.cfg中sql_alchemy_conn参数为对应数据库连接地址后，执行airflow db upgrade同步元数据，再重启scheduler
• 检查执行器配置：默认的SequentialExecutor为单线程执行器，调度效率极低，可根据需求替换为LocalExecutor或CeleryExecutor，修改配置后需同步元数据再重启服务
• 调整WSL资源限制：在Windows用户目录下新建.wslconfig文件，添加如下配置：

[wsl2]
memory=4G
processors=2
swap=2G

保存后在Windows PowerShell执行wsl --shutdown重启WSL实例生效

• 排查DAG文件异常：清空dags目录后重新启动scheduler，若恢复正常则是原有DAG存在语法错误、依赖缺失等问题，逐一排查DAG文件即可
  相关异常截图：
  

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