使用AWS MWAA Local Runner本地运行Airflow时DAG不显示

核心排查步骤 #

• 验证DAG目录挂载有效性
  先通过命令查看容器状态：

  docker-compose ps
  

  进入webserver容器检查内部DAG目录：

  docker-compose exec webserver bash
  ls -l /usr/local/airflow/dags
  

  如果容器内目录为空，说明本地./dags目录挂载失败，检查docker-compose.yml里的volumes配置，确保本地路径和容器内/usr/local/airflow/dags正确映射。

• 查看日志定位解析错误
  拉取webserver和scheduler的日志，排查Broken DAG类报错：

  docker-compose logs webserver
  docker-compose logs scheduler
  

  示例DAG也可能因依赖缺失、语法问题导致解析失败，日志会明确给出原因。

• 核对Airflow关键配置
  进入容器查看airflow.cfg的核心配置项：

  cat /usr/local/airflow/airflow.cfg | grep -E "dags_folder|load_examples"
  

  确保dags_folder指向挂载的容器目录，load_examples设为True。若配置有误，修改后重启服务：

  docker-compose restart scheduler webserver
  

• 强制触发DAG解析并刷新缓存
  在容器内手动列出DAG，验证解析是否正常：

  airflow dags list
  

  若命令行能列出但UI不显示，清空浏览器缓存后重启webserver容器：

  docker-compose restart webserver
  

• 调整本地DAG文件权限
  确保本地dags目录及文件权限适配容器运行用户：

  chmod -R 755 ./dags
  chown -R 50000:50000 ./dags
  

  MWAA容器默认以50000用户运行，权限不足会导致无法读取DAG文件。

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