Podman部署Airflow WebServer遇「Apache Airflow不在此位置」错误求助

核心问题分析 #

从日志和现象来看，Airflow WebServer已正常启动，但所有请求（根路径、/airflow路径）均返回404，说明路由配置与实际服务路径不匹配，或关键配置项使用错误。

排查步骤 #

• 验证路由前缀配置项
  Airflow 2.x中控制WebServer路径前缀的是AIRFLOW__WEBSERVER__URL_PREFIX，而非BASE_URL。BASE_URL仅用于定义外部访问的完整URL，不影响内部路由匹配。你之前的配置混淆了这两个参数，导致服务无法识别/airflow路径。

• 检查容器内配置实际生效情况
  进入WebServer容器，执行以下命令确认配置：

  # 查看URL_PREFIX配置
  airflow config get-value webserver url_prefix
  # 查看BASE_URL配置
  airflow config get-value webserver base_url
  

  也可以直接查看$AIRFLOW_HOME/airflow.cfg文件（默认/opt/airflow/airflow.cfg），确认配置是否正确加载。

• 确认WebServer监听状态
  在容器内执行ss -tulpn | grep 8080，检查8080端口是否被Airflow进程（gunicorn）监听。若未监听，说明WebServer启动异常，需检查数据库连接或初始化状态。

• 验证Airflow初始化状态
  执行airflow db check确认数据库连接正常；执行airflow users list确认存在管理员用户。若未初始化，需先执行初始化操作：

  airflow db init
  airflow users create --username admin --firstname Admin --lastname User --role Admin --email admin@example.com
  

解决方案建议 #

1. 修正环境变量配置 #

使用以下正确的环境变量启动WebServer容器：

AIRFLOW__WEBSERVER__WEB_SERVER_HOST=0.0.0.0
AIRFLOW__WEBSERVER__WEB_SERVER_PORT=8080
# 配置服务路径前缀为/airflow
AIRFLOW__WEBSERVER__URL_PREFIX=/airflow
# 外部访问的完整URL（对应Pod映射的8008端口）
AIRFLOW__WEBSERVER__BASE_URL=http://localhost:8008/airflow
# CLI访问的容器内服务地址
AIRFLOW__CLI__ENDPOINT_URL=http://localhost:8080/airflow

• WEB_SERVER_HOST=0.0.0.0：确保容器内外均可访问服务
• URL_PREFIX=/airflow：让WebServer在/airflow路径下挂载路由

2. 重启并验证服务 #

• 重启WebServer容器后，在容器内执行curl localhost:8080/airflow，应返回Airflow登录页面。
• 外部访问使用http://localhost:8008/airflow（对应Pod的端口映射8008:8080）。

3. 调试日志排查 #

若问题仍存在，开启DEBUG日志进一步排查：

AIRFLOW__LOGGING__LOG_LEVEL=DEBUG

重启WebServer后，查看日志中是否有路由加载相关的信息，确认/airflow路径是否被正确注册。

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