Win11运行airflow standalone报sqlite相对路径错误如何解决

核心报错原因 #

你遇到的问题来自两个配置错误：

• Windows CMD中set命令设置的环境变量仅对当前终端会话生效，且~是类Unix Shell的家目录通配符，Windows终端不会自动将其解析为C:\Users\admin的用户目录，导致你设置的AIRFLOW_HOME=~/airflow实际是无效路径，Airflow加载时自动拼接路径出现正反斜杠混用的问题。
• Airflow的sqlite连接串解析逻辑对路径格式要求严格，混用/和\、路径带非解析的通配符时，会把合法的Windows绝对路径误判为相对路径，抛出对应异常。

分步解决流程 #

1. 正确配置AIRFLOW_HOME环境变量 #

先选一种方式设置，设置完必须验证路径是否正确：

• 临时生效（仅当前打开的终端窗口有效）：
  如果你用CMD，激活venv后执行：
  set AIRFLOW_HOME=C:\Users\admin\airflow
  如果你用PowerShell，激活venv后执行：
  $env:AIRFLOW_HOME = "C:\Users\admin\airflow"
• 永久生效（所有终端都生效）：
  打开「此电脑→属性→高级系统设置→环境变量」，在当前用户的变量列表里新建条目，变量名填AIRFLOW_HOME，变量值填C:\Users\admin\airflow，保存后重启所有终端窗口。

配置完成后执行对应命令验证：

• CMD下执行echo %AIRFLOW_HOME%，输出C:\Users\admin\airflow即为正确
• PowerShell下执行echo $env:AIRFLOW_HOME，输出上述路径即为正确

2. 修正sqlite连接串配置 #

先删除C:\Users\admin\airflow目录下之前错误生成的airflow.db、airflow.cfg文件（如果目录不存在就手动新建这个空文件夹）。
后续执行初始化命令生成新的airflow.cfg后，找到文件中[database]段的sql_alchemy_conn配置项，修改为符合Windows路径规范的格式：
sql_alchemy_conn = sqlite:////C:/Users/admin/airflow/airflow.db
注意：路径全部使用正斜杠，不要混用反斜杠，sqlite前缀后是4个斜杠，不要少写

3. 重新初始化并启动 #

回到激活了venv的终端，依次执行以下命令：

• 执行airflow db init初始化数据库，这一步没有路径类报错就说明配置正确
• 执行airflow standalone启动服务，启动成功后终端会打印自动生成的admin账号密码，访问http://localhost:8080即可进入Airflow控制台

补充提示：Apache Airflow官方没有对Windows原生环境做完整兼容，如果后续出现进程信号、文件权限类的不可兼容报错，建议切换到WSL2环境部署，稳定性会高很多。

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