无root权限Linux安装Apache Airflow后命令缺失及模块错误求助

你遇到的问题主要是Python版本不匹配和自定义安装目录的模块路径未配置导致的，下面一步步帮你解决：

1. 先排查Python版本冲突问题 #

builtins是Python 3的内置模块，报错提示找不到它，大概率是你运行airflow脚本时默认调用了Python 2，但你是用pip3（对应Python 3）安装的Airflow，两者版本不兼容。

你可以直接用Python 3来运行脚本测试：

python3 /dir/subdir/airflow/bin/airflow

如果这条命令能正常执行，那就是脚本的shebang（第一行的解释器指定）有问题，需要修改airflow脚本的第一行：

• 打开/dir/subdir/airflow/bin/airflow文件，把开头的#!/usr/bin/env python改成#!/usr/bin/env python3，保存后再直接运行./dir/subdir/airflow/bin/airflow应该就可以了。

2. 配置PYTHONPATH让解释器识别安装的模块 #

用--target参数安装的包，Python解释器默认不会把这个目录加入模块搜索路径，所以即使你用Python3运行，也可能找不到Airflow的依赖。

你可以在运行前临时设置环境变量：

export PYTHONPATH="/dir/subdir:$PYTHONPATH"
python3 /dir/subdir/airflow/bin/airflow

如果想让这个配置永久生效，可以把上面的export命令添加到你的shell配置文件里（比如~/.bashrc、~/.zshrc，根据你使用的shell选择），之后每次打开终端都会自动加载这个路径。

3. 更推荐的替代方案：使用虚拟环境 #

因为Airflow依赖非常多，用--target安装很容易出现路径和依赖冲突问题，即使没有root权限，你也可以创建自己的Python虚拟环境来隔离依赖：

# 创建虚拟环境（路径可以自定义，比如~/airflow_venv）
python3 -m venv ~/airflow_venv
# 激活虚拟环境
source ~/airflow_venv/bin/activate
# 安装Airflow，此时不需要--target参数
pip install apache-airflow[postgres,ssh,jdbc]

激活虚拟环境后，直接运行airflow命令就可以正常使用，完全不用担心路径和版本的问题。

最后提醒一下：Airflow 2.x版本要求Python 3.7及以上，确保你的Python3版本符合要求哦。

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