Docker-Compose卷映射异常？Airflow目录映射问题排查

核心问题原因 #

你的卷映射逻辑本身没有错误，但容器仍在airflow文件夹外创建目录，通常是以下几个原因导致的：

• 环境变量AIRFLOW_PROJ_DIR未正确生效，被默认值覆盖
• 本地airflow目录下的dags/logs/plugins子目录未提前创建
• 旧的Docker卷缓存干扰了新配置
• 目录权限不匹配导致容器无法访问映射目录

分步修复方案 #

1. 提前创建完整的本地目录结构 #

确保airflow目录下的三个子目录都已创建（仅创建airflow父目录不够），在docker-compose.yml所在的目录执行：

mkdir -p ./airflow/dags ./airflow/logs ./airflow/plugins

同时设置Airflow容器用户的权限（容器内默认用户UID为50000）：

chown -R 50000:50000 ./airflow

2. 确保环境变量正确生效 #

如果使用${AIRFLOW_PROJ_DIR:-./airflow}的写法，需要显式设置环境变量避免被默认值覆盖：

• 临时生效（当前终端会话）：

export AIRFLOW_PROJ_DIR=./airflow

• 永久生效（写入shell配置文件，如~/.bashrc或~/.zshrc）：

echo "export AIRFLOW_PROJ_DIR=./airflow" >> ~/.bashrc
source ~/.bashrc

或者直接在docker-compose.yml的environment块中为所有Airflow服务添加：

services:
  airflow-webserver:
    environment:
      - AIRFLOW_PROJ_DIR=./airflow
  airflow-scheduler:
    environment:
      - AIRFLOW_PROJ_DIR=./airflow
  airflow-worker:
    environment:
      - AIRFLOW_PROJ_DIR=./airflow

3. 清理旧Docker卷缓存 #

之前执行的docker-compose up可能留下了旧的匿名卷或缓存，导致新配置不生效，执行以下命令清理：

docker-compose down -v

清理完成后，重新初始化并启动容器：

docker-compose up airflow-init
docker-compose up

4. 改用绝对路径映射（最稳妥） #

如果相对路径解析仍有问题，直接使用本地目录的绝对路径避免歧义，例如：

volumes:
  - /home/your-username/your-project/airflow/dags:/opt/airflow/dags
  - /home/your-username/your-project/airflow/logs:/opt/airflow/logs
  - /home/your-username/your-project/airflow/plugins:/opt/airflow/plugins

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