导入Airflow包运行Python文件是否需实例？求无副作用导入方法

问题根源 #

Airflow的顶层__init__.py文件在导入时会自动执行全局初始化逻辑，包括加载配置、初始化ORM、连接数据库等操作。因此只要导入airflow包下的任何模块，都会触发这些副作用，导致你遇到数据库路径报错，且无法在无初始化的情况下使用Airflow的类或类型。

解决方案 #

1. 类型提示场景：用typing.TYPE_CHECKING实现无运行时导入

如果你的需求只是类型标注，可以借助Python的typing.TYPE_CHECKING常量——它在代码运行时为False，仅在类型检查工具（如mypy）运行时为True。将导入代码放在该判断块中，运行时不会执行导入，自然不会触发Airflow的初始化。

示例代码：

from typing import TYPE_CHECKING

if TYPE_CHECKING:
    # 仅类型检查阶段执行，运行时跳过
    from airflow import DAG

def process_dag(dag: DAG) -> None:
    pass

print("Hello world")

也可以直接使用字符串类型提示，无需导入：

def process_dag(dag: "DAG") -> None:
    pass

2. 直接导入底层模块（谨慎使用）

部分Airflow的底层模块可能不会触发全局初始化，但该方法依赖Airflow内部实现，不同版本可能失效。尝试直接导入具体类的文件路径：

# 绕过顶层airflow包，直接导入DAG类文件
from airflow.models.dag import DAG

print("Hello world")

注意：若底层模块间接依赖settings，依然会触发初始化，需测试验证。

3. 必须实际导入时：临时配置Airflow环境

如果需要在运行时实际导入Airflow模块，可通过设置环境变量修正数据库路径，避免初始化报错：

• Windows终端：

set AIRFLOW__CORE__SQL_ALCHEMY_CONN=sqlite:///C:/Users/Jarro/airflow/airflow.db

• Linux/macOS终端：

export AIRFLOW__CORE__SQL_ALCHEMY_CONN=sqlite:////Users/Jarro/airflow/airflow.db

执行上述命令后再运行脚本，Airflow会使用正确的绝对路径数据库完成初始化，但此方法依然会触发完整初始化流程，无法消除副作用。

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