Apache Airflow 2.0 首次创建DAG未在列表中展示问题求助

• 优先检查导入错误：执行 airflow dags list-import-errors 命令，查看目标DAG文件是否存在语法报错、依赖缺失、DAG ID重复等问题，这是占比最高的故障原因。
• 验证DAG文件权限：确认Airflow运行进程的所属用户对dags目录下的目标py文件有可读权限，可执行 chmod 644 /Users/vik/src/airflow/dags/你的DAG文件名.py 赋权后重试。
• 核对DAG代码逻辑：
  • 确认代码中已完成DAG实例化，所有Operator均关联了对应DAG对象
  • 不要将DAG实例化的代码放在if __name__ == "__main__"代码块内，scheduler扫描文件时不会执行该块内容，会导致DAG无法被识别
• 确认加载路径一致：执行 airflow config get-value core dags_folder 命令，确认输出的路径和你存放py文件的/Users/vik/src/airflow/dags完全匹配，避免环境变量AIRFLOW_HOME变动导致加载了其他位置的配置文件。
• 检查scheduler运行状态：查看scheduler日志（默认存放在$AIRFLOW_HOME/logs/scheduler目录下），确认进程没有异常退出，且正常执行dags目录扫描任务。
• 等待扫描周期：Airflow默认每30秒扫描一次dags目录，修改文件后等待1~2分钟再刷新UI，不要修改后立刻刷新。
• 检查DAG状态开关：如果DAG配置了is_paused_upon_creation=True（默认值为True），新识别的DAG会默认处于暂停状态，可在Web UI顶部勾选「显示暂停的DAG」选项查看。

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