安装Airflow后执行airflow standalone提示找不到airflow模块求助

环境信息 #

• 系统：Suse SLES-15.4
• Python版本：3.10.11，运行状态正常：

~> python3 -c "import os, sys; print(os.path.dirname(sys.executable))"
/usr/bin
~> pip3 --version
pip 22.0.4 from /usr/lib/python3.10/site-packages/pip (python 3.10)

安装操作 #

为避免应用安装到个人主目录，创建目标目录并设置环境变量：

export AIRFLOW_HOME=/usr/lib/airflow

按照Airflow快速入门指南执行安装命令：

AIRFLOW_VERSION=2.6.1
PYTHON_VERSION="$(python3 --version | cut -d " " -f 2 | cut -d "." -f 1-2)"
CONSTRAINT_URL=https://raw.githubusercontent.com/apache/airflow/constraints-${AIRFLOW_VERSION}/constraints-${PYTHON_VERSION}.txt
pip3 install -t $AIRFLOW_HOME "apache-airflow==${AIRFLOW_VERSION}" --constraint "${CONSTRAINT_URL}"

排查配置尝试 #

编辑/etc/profile.d/python.sh添加环境变量：

# add python startup script for interactive sessions
export PYTHONSTARTUP=/etc/pythonstart
export LC_ALL="fr_CH.UTF-8"
export AIRFLOW_HOME=/usr/lib/airflow
export PATH=/usr/lib:/usr/lib/airflow:/usr/lib/airflow/bin:$PATH
export LD_LIBRARY_PATH=/usr/lib/airflow:/usr/lib/airflow/bin/airflow:/usr/lib/python3.10:/usr/lib/python3.10/site-packages:$LD_LIBRARY_PATH

报错详情 #

执行airflow standalone时触发错误：

~> airflow standalone
Traceback (most recent call last):
  File "/usr/lib/airflow/bin/airflow", line 5, in <module>
    from airflow.__main__ import main
ModuleNotFoundError: No module named 'airflow'

解决建议 #

• 检查Python模块搜索路径：执行python3 -c "import sys; print(sys.path)"，确认/usr/lib/airflow是否在输出列表中。若未存在，需在/etc/profile.d/python.sh中添加：

  export PYTHONPATH=/usr/lib/airflow:$PYTHONPATH
  

  添加后执行source /etc/profile.d/python.sh生效，再重新运行airflow。

• 验证Airflow安装目录：检查/usr/lib/airflow下是否存在airflow子目录（即/usr/lib/airflow/airflow）。若不存在，说明安装过程存在异常，重新执行pip安装命令并查看日志排查错误。

• 确认安装权限：由于目标目录是/usr/lib，需确保pip命令有足够权限，建议添加sudo重新安装：

  sudo pip3 install -t $AIRFLOW_HOME "apache-airflow==${AIRFLOW_VERSION}" --constraint "${CONSTRAINT_URL}"
  

• 检查命令指向：执行which airflow，确认输出为/usr/lib/airflow/bin/airflow。若不是，调整PATH变量中/usr/lib/airflow/bin的顺序，将其放在系统默认路径之前。

• 排除虚拟环境冲突：确保当前未激活其他Python虚拟环境，避免模块路径被干扰。

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