运行Airflow初始化命令时出现PydanticUserError如何解决

问题根源在于Airflow 2.6.2不兼容Pydantic V2，Airflow 2.6.2的依赖清单明确要求pydantic<2.0，而你的环境中安装了Pydantic V2，导致API冲突（比如orm_mode重命名、类型注解规则变化）。

以下是具体解决步骤：

1. 检查当前Pydantic版本
   运行命令查看已安装的Pydantic版本：

   pip show pydantic
   

   如果输出的Version是2.x系列，说明版本不兼容。

2. 降级Pydantic到兼容版本
   执行命令安装Airflow 2.6.2支持的Pydantic V1版本：

   pip install "pydantic<2.0"
   

   更稳妥的做法是指定具体兼容版本：

   pip install pydantic==1.10.12
   

3. 验证修复效果
   重新运行airflow standalone，此时Pydantic相关的警告和错误应该会消失。

额外建议：使用虚拟环境隔离依赖 #

为了避免全局包版本冲突，建议为Airflow项目创建独立的虚拟环境：

• 创建虚拟环境：

  python -m venv airflow-venv
  

• 激活虚拟环境：
  • Linux/macOS：source airflow-venv/bin/activate
  • Windows：airflow-venv\Scripts\activate
• 在虚拟环境中安装Airflow 2.6.2，会自动安装兼容的依赖包：

  pip install apache-airflow==2.6.2
  

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