Windows11执行airflow db init报错及配置文件未生成求助

核心原因 #

Airflow官方仅支持POSIX兼容系统（Linux、macOS），原生Windows环境存在兼容性问题，报错中的RuntimeWarning已明确提示这点。

问题1：airflow db init执行报错 #

报错的直接原因是SQLite路径格式错误：Windows路径的斜杠混合导致Airflow识别为相对路径。同时Windows不支持Airflow需要的符号链接操作，也会引发OSError。

临时修复（不推荐长期使用） #

如果一定要在原生Windows尝试：

• 手动生成配置文件：执行命令

  airflow config list > airflow.cfg
  

• 编辑生成的airflow.cfg：
  1. 找到sql_alchemy_conn配置项，将默认的sqlite:///C:\Users\dell\airflow/airflow.db修改为符合要求的绝对路径格式：

     sql_alchemy_conn = sqlite:////C:/Users/dell/airflow/airflow.db
     

  2. 若要切换到PostgreSQL，先安装依赖包：

     pip install psycopg2-binary
     

     然后修改连接串为：

     sql_alchemy_conn = postgresql+psycopg2://你的用户名:密码@localhost:5432/airflow数据库名
     

• 重新执行初始化：

  airflow db init
  

问题2：配置文件未生成 #

配置文件airflow.cfg仅在airflow db init成功执行后才会自动生成。由于初始化报错失败，所以不会生成该文件，按照上述手动生成的方法即可创建。

推荐方案（长期稳定） #

使用WSL2运行Airflow：

• 启用Windows的WSL2功能，安装Ubuntu等Linux发行版。
• 在WSL环境内按照Airflow官方文档完成安装、初始化操作，所有功能都能正常运行，配置文件会自动生成在~/airflow/airflow.cfg路径下。

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