WSL2 Ubuntu中Airflow db init报错：'logo'属性不被允许

问题根源 #

降级时未彻底清除Airflow 2.5.0的残留配置文件与依赖，导致2.0.0版本的配置验证规则（jsonschema）识别到不兼容的logo字段；同时手动指定wtforms、marsmallow版本可能破坏了Airflow官方依赖链。

解决步骤 #

1. 彻底清理旧环境 #

• 卸载所有Airflow相关包：

  pip uninstall -y apache-airflow apache-airflow-providers-*
  

• 删除Airflow默认配置目录：

  rm -rf ~/airflow
  

• 清理pip缓存，避免残留旧版本包：

  pip cache purge
  

2. 创建独立虚拟环境（关键） #

避免系统全局Python依赖污染，确保Airflow 2.0.0的依赖完全隔离：

• 安装virtualenv（若未安装）：

  sudo apt update && sudo apt install python3-virtualenv
  

• 创建并激活针对Airflow 2.0.0的虚拟环境（Airflow 2.0.0兼容Python 3.6-3.8，此处以3.8为例）：

  virtualenv -p python3.8 ~/airflow-2.0.0-env
  source ~/airflow-2.0.0-env/bin/activate
  

3. 按官方约束文件安装Airflow 2.0.0 #

使用Airflow官方提供的约束文件，自动匹配所有依赖的正确版本，避免手动安装导致的冲突：

• 设置版本相关环境变量：

  export AIRFLOW_VERSION=2.0.0
  export PYTHON_VERSION="$(python --version | cut -d " " -f 2 | cut -d "." -f 1-2)"
  export CONSTRAINT_URL="https://raw.githubusercontent.com/apache/airflow/constraints-${AIRFLOW_VERSION}/constraints-${PYTHON_VERSION}.txt"
  

• 安装Airflow 2.0.0：

  pip install "apache-airflow==${AIRFLOW_VERSION}" --constraint "${CONSTRAINT_URL}"
  

4. 重新初始化数据库 #

此时使用的是全新的配置文件，无旧版本残留字段，执行初始化：

airflow db init

5. 排查全局配置干扰（若仍报错） #

• 检查Airflow配置目录：

  echo $AIRFLOW_HOME
  

• 若输出非~/airflow，说明存在自定义配置路径，删除该路径下所有文件后重新执行airflow db init。

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