Airflow GitSync同步正常但Scheduler及UI无DAG显示问题排查

• 挂载路径配置错误：你设置的dags.mountPath: ~会将同步目录挂载到容器主目录（如/home/airflow），但Airflow默认读取DAG的路径是/opt/airflow/dags。修改配置：

  dags:
    mountPath: /opt/airflow/dags
    # 其余配置保持不变
  

• 卷挂载共享验证：确保git-sync同步的/git/repo/dags目录通过共享卷挂载到Scheduler和Webserver主容器的/opt/airflow/dags路径。可通过以下命令验证主容器中是否存在DAG文件：

  kubectl exec -it airflow-scheduler-0 -n airflow -- ls -la /opt/airflow/dags
  

• 文件权限问题：Airflow进程以airflow用户（UID 50000）运行，需确保该用户对DAG文件有读取权限。可在git-sync配置中添加syncPermissions: true自动同步权限，或手动调整：

  kubectl exec -it airflow-scheduler-0 -n airflow -- chown -R 50000:50000 /opt/airflow/dags
  

• DAG文件语法检查：语法错误会导致Airflow无法解析DAG。进入Scheduler容器检查：

  # 列出所有可解析的DAG
  kubectl exec -it airflow-scheduler-0 -n airflow -- airflow dags list
  # 检查单个DAG文件语法
  kubectl exec -it airflow-scheduler-0 -n airflow -- python /opt/airflow/dags/your_dag_file.py
  

• Airflow解析配置确认：检查airflow.cfg中的dags_folder是否为/opt/airflow/dags，dag_dir_list_interval是否设置合理（默认5分钟，需等待足够时间让Airflow扫描新DAG），同时确认load_examples为False避免示例DAG干扰。

内容的提问来源于stack exchange，提问作者Michal Heneš