Airflowは、変更に気づくためにすべてのDagファイルを何度も解析します。ファイルの実行で例外が発生すると、そのファイルはインポートエラーになります:そのDagは一覧から消えますが、ほかのファイルのDagは動き続けます。Dagsのページには赤いバナーが表示され、airflow dags list-import-errorsがトレースバックを表示します。
よくある原因は、インポートのタイプミス(DAGではなくfrom airflow.sdk import Dag)、Airflow 3でもう受け付けられない引数(schedule_interval)、タスクのIDの重複(多くの場合、1つのIDを使い回すループによるもの)、無効なID、循環です。
解析では、すべてのトップレベルのコード、つまりタスクの関数の外のすべてが実行されます。それは速く、副作用のないものにしてください。ファイルの先頭のデータベースのクエリやAPIの呼び出しは、ファイルが解析されるたびに実行され、Dagプロセッサーを遅くし、そのシステムの障害をインポートエラーに変えてしまいます。その処理は、実行ごとに一度実行されるタスクの中に置いてください。