Airflow 1.9 Web Server异常：无法基于Gunicorn启动且UI不可访问

我之前也碰到过Airflow 1.9搭配Gunicorn的类似启动异常问题，结合你的描述给你几个实用的排查方向：

• 锁定Gunicorn兼容版本
  Airflow 1.9对Gunicorn的版本兼容性要求很严格，过高或过低的版本都会导致启动无响应、无日志的情况。建议安装官方推荐的稳定版本：

  pip install gunicorn==19.7.1
  

  我之前就是不小心升级到Gunicorn 20+版本后出现了和你一模一样的问题，回退到19.7.1后立即恢复正常。

• 强制指定Gunicorn日志输出
  默认情况下Gunicorn的日志可能没有定向到Airflow的日志目录，导致你看不到任何启动信息。启动时显式指定日志参数试试：

  airflow webserver -w 2 --gunicorn-log-level=debug --log-file=$AIRFLOW_HOME/logs/gunicorn_webserver.log
  

  启动后去查看这个指定的日志文件，几乎肯定能找到启动失败的具体原因——比如依赖缺失、端口被占用、配置文件语法错误等。

• 校验Airflow配置文件的Web Server参数
  打开$AIRFLOW_HOME/airflow.cfg检查以下关键配置：

  • 用netstat -tulpn | grep 8080（默认端口是8080）确认web_server_port没有被其他进程占用；
  • 确保web_server_host设置为0.0.0.0或你能访问的IP，不要设成localhost导致外部无法访问；
  • gunicorn_workers的数值不要超过系统CPU核心数的2倍，过高会导致资源耗尽启动失败。

• 绕过Airflow脚本直接启动Gunicorn
  跳过Airflow的启动脚本，直接用Gunicorn启动Airflow Web Server的核心入口，验证基础服务是否正常：

  gunicorn -w 2 -b 0.0.0.0:8080 airflow.www.app:app
  

  如果这个命令能正常启动并输出日志，说明问题出在Airflow的启动脚本封装上；如果还是无响应，那大概率是Gunicorn和Airflow的核心依赖冲突，建议重建Airflow的虚拟环境。

• 检查目录权限
  确认$AIRFLOW_HOME及其子目录（尤其是logs、pid文件夹）的读写权限属于Airflow的运行用户，权限不足会导致无法生成pid文件和写入日志。可以用下面的命令修复：

  chown -R <你的运行用户名>:<用户组> $AIRFLOW_HOME
  

另外你提到卸载Gunicorn后启动的情况没写完，不过如果卸载后Airflow自带的Werkzeug服务器能正常启动，那就更能确定问题根源在Gunicorn的版本或配置上了。

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