Virtualbox Ubuntu环境下所有Airflow命令均提示command not found

问题场景：Airflow部署在Virtualbox运行的Ubuntu系统中，通过VS Code SSH连接操作时，执行airflow scheduler、sudo airflow scheduler均返回command not found错误，报错截图如下：

核心原因 #

• Airflow未被安装在系统默认PATH覆盖的路径下，常见安装位置为Python虚拟环境目录、当前用户的~/.local/bin目录，未被加入SSH会话的环境变量
• sudo执行命令时会默认重置PATH环境变量，即使用户本地配置了路径，sudo状态下也无法识别

解决步骤 #

1. 定位Airflow可执行文件的实际路径 #

执行如下命令扫描全系统可执行的airflow文件：

find / -name airflow -type f -executable 2>/dev/null

常见返回路径分为三类：

• 虚拟环境路径：示例/home/[你的用户名]/airflow_venv/bin/airflow
• 用户本地pip安装路径：示例/home/[你的用户名]/.local/bin/airflow
• 全局安装路径：示例/usr/local/bin/airflow

2. 临时验证可用性 #

使用全路径执行命令测试，比如你扫描得到的路径为~/.local/bin/airflow，执行：

~/.local/bin/airflow scheduler

如果可以正常启动，即可确认是PATH配置问题。

3. 永久配置普通用户执行权限 #

编辑当前用户的bash配置文件：

nano ~/.bashrc

在文件末尾追加如下内容，将<airflow所在目录>替换为你第一步得到的路径的目录部分（比如airflow路径为~/.local/bin/airflow，就填~/.local/bin）：

export PATH=$PATH:<airflow所在目录>

保存退出后重载配置生效：

source ~/.bashrc

后续普通用户可直接执行airflow相关命令。

4. sudo执行场景适配 #

如果需要使用sudo权限执行airflow命令，可选两种方案：

• 直接使用全路径执行：sudo <第一步得到的airflow全路径> scheduler
• 配置sudo安全路径：执行sudo visudo，找到Defaults secure_path配置项，将airflow所在目录追加到参数末尾，用冒号分隔即可。

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