Airflow无法识别$AIRFLOW_HOME目录？权限问题排查求助

1. 权限拒绝问题的本质 #

你看到的/bin/sh: 1: /opt/airflow: Permission denied错误，是因为直接输入$AIRFLOW_HOME时，shell会尝试执行这个目录（而非输出变量值），目录本身没有可执行权限才触发报错。正确查看环境变量的命令应该是：

echo $AIRFLOW_HOME

这属于命令使用错误，并非配置遗漏。但挂载目录后的路径访问问题，核心原因是本地挂载文件与容器内airflow用户的权限不匹配：官方Airflow镜像中airflow用户的UID/GID默认是50000，而你本地./files目录的所有者是本地用户（比如UID 1000），导致airflow用户无读取/执行权限。

2. 相对路径失效的原因 #

Airflow的BashOperator默认工作目录并非$AIRFLOW_HOME，而是容器的默认工作目录（通常为/）。你直接用python files/my-repo/task.py时，shell会在当前工作目录下查找files文件夹，自然无法找到。

你之前的认知有误：$AIRFLOW_HOME是Airflow存放配置、DAG、日志等核心文件的目录，但它不会自动成为所有Operator的默认工作目录，也不会自动将其子目录加入Python的sys.path（除非手动配置）。

3. 具体解决步骤 #

（1）修复挂载目录权限 #

两种方式任选其一：

• 推荐方式：启动容器时同步UID/GID
  在docker-compose.yml或docker run命令中添加环境变量，让容器内airflow用户与本地用户权限一致：

  environment:
    - AIRFLOW_UID=$(id -u)
    - AIRFLOW_GID=$(id -g)
  

• 直接修改本地目录权限
  把本地./files目录的所有者改为镜像默认的airflow用户UID/GID：

  chown -R 50000:50000 ./files
  

（2）让BashOperator使用$AIRFLOW_HOME作为工作目录 #

在BashOperator中显式指定cwd参数，设置为$AIRFLOW_HOME，这样相对路径即可正常使用：

BashOperator(
    task_id="run_task",
    bash_command="python files/my-repo/task.py",
    cwd="{{ var.value.AIRFLOW_HOME }}"  # 也可直接写死"/opt/airflow"
)

（3）可选：将files目录加入Python路径 #

如果task.py需要导入Airflow模块或自定义模块，可在bash命令中先添加路径：

bash_command='export PYTHONPATH="/opt/airflow/files:$PYTHONPATH" && python files/my-repo/task.py'

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