Windows11安装Airflow执行airflow standalone时遇SQLite3 DLL错误求助

问题原因 #

Airflow默认依赖SQLite作为元数据库，你的Python环境中缺失sqlite3.dll文件，或者该文件的路径未被系统识别，导致导入_sqlite3模块失败，无法完成数据库初始化。

解决方案 #

• 检查Python的SQLite组件完整性
  打开Python交互终端，执行import sqlite3，如果同样报错，说明你的Python安装包未包含SQLite支持。卸载当前Python，从Python官方渠道重新下载对应版本的安装包，选择「自定义安装」并确保勾选SQLite相关组件后完成安装。

• 修复sqlite3.dll文件及路径

  1. 找到Python安装目录下的DLLs文件夹（例如C:\Python310\DLLs），确认是否存在sqlite3.dll。
  2. 若文件缺失：重新运行Python安装程序，选择「修改」选项，勾选SQLite组件后完成安装。
  3. 若文件存在但报错：将Python的DLLs文件夹路径添加到系统PATH环境变量中，步骤如下：
     • 右键「此电脑」→ 属性 → 高级系统设置 → 环境变量 → 在系统变量中找到PATH并点击编辑
     • 添加对应路径（如C:\Python310\DLLs），点击确定后重启VSCode和终端。

• 替换SQLite DLL文件（备选）
  若上述方法无效，下载与Python位数（32/64位）匹配的SQLite预编译DLL文件，替换PythonDLLs文件夹中的sqlite3.dll，之后重启终端重试airflow standalone命令。

• 切换至其他数据库（备选方案）
  如果SQLite问题无法解决，可以修改Airflow配置文件airflow.cfg，将sql_alchemy_conn配置项改为PostgreSQL或MySQL的连接字符串。例如：

  sql_alchemy_conn = postgresql+psycopg2://your_username:your_password@localhost/airflow_db
  

  注意：使用前需提前安装对应数据库及Python驱动（如psycopg2-binary用于PostgreSQL）。

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