Airflow 1.10.15升级至2.4.3时upgrade_check命令报错求助

问题原因 #

Airflow 2.x版本已移除airflow upgrade_check子命令，该升级检查功能由独立的apache-airflow-upgrade-check包提供，需直接调用upgrade_check命令，而非通过airflow前缀执行。

具体解决步骤 #

• 进入运行中的Airflow容器（以webserver容器为例，根据你的Docker Compose配置替换容器名）：

  docker-compose exec airflow-webserver bash
  

• 确认apache-airflow-upgrade-check包已安装：

  pip show apache-airflow-upgrade-check
  

  若未安装，执行安装命令：

  pip install apache-airflow-upgrade-check
  

• 直接运行升级检查命令：

  upgrade_check
  

关键注意事项 #

• 数据库连接配置：运行检查前，需确保当前Airflow 2.x容器能访问原Airflow 1.10.15的元数据库。可通过修改容器内的airflow.cfg配置文件，或设置对应的环境变量（如AIRFLOW__DATABASE__SQL_ALCHEMY_CONN）指定原数据库连接信息。
• Dockerfile集成：若要在镜像构建阶段预装工具，需在Dockerfile中添加：

  RUN pip install apache-airflow-upgrade-check
  

  运行容器时直接执行upgrade_check命令，而非airflow upgrade_check。
• 检查报告处理：执行完成后，工具会输出详细的升级建议（如DAG语法调整、废弃API替换、依赖版本兼容等），需逐一处理后再进行正式升级。

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