Docker单独挂载airflow.cfg文件失败仅生成同名文件夹如何解决

Docker单文件挂载时会先校验宿主机（本地）的挂载源路径：如果本地指定的源文件不存在，Docker会默认把该路径判定为目录，自动创建同名空文件夹，这就是配置单文件挂载后本地出现airflow.cfg文件夹、无法映射文件的核心原因。
挂载整个/opt/airflow/目录能正常同步内容，是因为目录挂载的逻辑是：如果本地源目录为空，Docker会自动把容器内对应目录的全量内容同步到本地，不存在「路径是文件还是目录」的判定歧义。但直接挂载整个Airflow根目录风险很高，会覆盖容器内自带的运行时依赖文件，很容易导致服务启动失败，不推荐这么做。

• 第一步：手动在本地提前创建好目标文件，不要让Docker自动生成路径。在你的docker-compose.yml所在目录执行以下命令：

# 创建config目录
mkdir -p ./config
# 生成空的airflow.cfg文件
touch ./config/airflow.cfg

• 第二步：先临时启动Airflow容器，把容器内初始生成的airflow.cfg配置文件拷贝到本地，保证本地文件内容和容器内初始配置完全一致：

# 命令里的airflow-webserver替换成你自己docker-compose里定义的Airflow主服务名即可
docker compose cp airflow-webserver:/opt/airflow/airflow.cfg ./config/airflow.cfg

• 第三步：修改docker-compose.yml的volumes配置，保留单文件挂载规则即可，不需要挂载整个根目录：

volumes:
  - ./dags:/opt/airflow/dags
  - ./logs:/opt/airflow/logs
  - ./plugins:/opt/airflow/plugins
  - ./config/airflow.cfg:/opt/airflow/airflow.cfg

• 第四步：重启容器让挂载生效，之后直接修改本地./config/airflow.cfg的内容，容器内的配置文件会实时同步，不会再出现生成同名文件夹的问题。

• 单文件挂载必须提前在本地创建好对应文件，只要本地源文件不存在，Docker就会自动创建同名目录，挂载必然失败
• 部分Airflow配置项修改后需要重启对应服务才能生效，修改完记得重启容器
• 不要直接挂载整个/opt/airflow/根目录到本地，会覆盖容器内置的启动脚本、依赖文件，大概率导致服务启动异常

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