求助：Airflow WEB UI无法找到已存放至正确目录的指定DAG

• 检查DAG脚本语法错误
  直接本地运行DAG文件：python your_dag_file.py，如果存在语法错误、依赖缺失、变量未定义等问题，会直接抛出异常，这是最常见的排查起点。

• 验证文件命名与权限配置

  • 确认文件名符合规则：必须以.py结尾，不包含Airflow默认忽略的模式（可查看airflow.cfg里的dag_ignore_patterns，比如以_开头或含test的文件可能被忽略）。
  • 调整文件权限：确保Airflow调度器进程能读取该文件，执行chmod +r your_dag_file.py，同时检查父目录的访问权限是否正常。

• 查看调度器日志定位根因
  前往默认日志路径$AIRFLOW_HOME/logs/scheduler，搜索目标DAG文件名的相关日志，通常会明确标注无法加载的原因——比如DAG ID重复、default_args缺少必填项、start_date设置为未来时间等。

• 核对DAG定义的正确性

  • 确认DAG对象被正确实例化，没有被误赋值为None，也不存在多个同名DAG的情况。
  • 检查default_args：必须包含owner、start_date等必填参数，start_date不能是未来时间。
  • 验证schedule_interval：如果设置为None且未配置手动触发规则，可能不会在UI中显示，这类问题会在日志中有明确提示。

• 清理缓存并重新解析DAG
  Airflow会缓存DAG元数据，执行以下命令强制清理并重新解析：

  airflow dags delete your_dag_id
  airflow dags parse your_dag_file.py
  

  完成后重启调度器与Webserver：

  airflow scheduler restart
  airflow webserver restart
  

• 手动清理数据库残留数据
  若之前的airflow db reset和airflow db init未彻底清除旧元数据，可直接查询数据库（以PostgreSQL为例）：

  SELECT * FROM dag WHERE dag_id = 'your_dag_id';
  

  如果存在旧记录，手动删除后再重新解析DAG。

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