Airflow DAG未显示在DAG列表中问题排查求助

一、DAG存放目录配置问题 #

• 确认DAG目录配置：执行命令 airflow config get-value core dags_folder，查看Airflow当前指定的DAG存放目录，确保你的DAG文件确实放在这个目录下。
• 检查目录权限：Airflow运行用户需要有该目录的读取权限，用 ls -l 查看目录权限，确保对应用户（比如airflow用户）能访问目录及里面的文件。
• 刷新Airflow服务：新增DAG或修改配置后，重启airflow scheduler和airflow webserver服务，或者等待30秒（默认扫描间隔）让scheduler自动识别新DAG。

二、DAG文件本身的问题 #

• 检查语法错误：直接运行 python 你的DAG文件名.py，如果有语法报错，Airflow会自动忽略这个文件，先修复所有语法问题。
• 确认DAG实例已全局化：文件里的DAG对象必须在全局作用域中实例化，不能放在函数或类的内部，否则Airflow扫描不到。
• 核对dag_id：确保你在终端用airflow dags list查找的dag_id和文件中定义的完全一致，注意大小写敏感。
• 检查start_date：start_date不能设置为未来时间，否则Airflow会判定该DAG暂未生效，不会显示在列表中。
• 确认文件后缀：DAG文件必须以.py为后缀，Airflow只会扫描目录下的Python文件作为DAG源文件。

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