Airflow：config list命令无法显示Docker环境变量覆盖值的问题

问题现象 #

配置Airflow的EmailOperator实现流水线通知时，通过Docker Compose的environment字段传入了SMTP及核心配置变量：

• AIRFLOW__SMTP__SMTP_HOST: smtp.gmail.com
• AIRFLOW__SMTP__SMTP_USER: xxx@gmail.com
• AIRFLOW__SMTP__SMTP_PASSWORD: xxx
• AIRFLOW__SMTP__SMTP_PORT: 587
• AIRFLOW__SMTP__SMTP_MAIL_FROM: xxx@gmail.com
• AIRFLOW__CORE__LOAD_EXAMPLES: false

实际功能已正常生效：GUI中无示例DAG，EmailOperator能正常发送邮件，但在主机执行airflow config list或airflow config get-value时，返回的仍是默认配置（比如load_examples = True、smtp_host = localhost），甚至官方Docker镜像自带的AIRFLOW__CORE__EXECUTOR: CeleryExecutor也无法在命令输出中显示。

问题原因 #

1. 执行环境不匹配：直接在主机执行airflow config list，读取的是主机本地的Airflow配置文件（或系统默认配置），而非Docker容器内部的运行时配置。容器与主机的文件系统、环境变量完全隔离，主机的airflow命令无法感知容器内的环境变量注入。
2. Airflow配置加载逻辑：Docker环境下，通过AIRFLOW__*格式注入的环境变量是Airflow运行时直接读取的，不会写入容器内的airflow.cfg文件。而airflow config list命令默认优先读取配置文件内容，仅当配置文件无对应项时才会读取环境变量——但如果你在容器外执行该命令，连容器的环境变量都无法访问。

正确校验配置的方法 #

1. 进入容器内部执行配置查看命令 #

• 先通过docker ps找到Airflow容器的名称（比如airflow-webserver、airflow-scheduler）
• 进入容器终端：

  docker exec -it <容器名称> bash
  

• 在容器内执行配置查看命令，比如：

  # 查看所有配置
  airflow config list
  # 查看单个配置项
  airflow config get-value core load_examples
  airflow config get-value smtp smtp_host
  

  此时输出的就是容器内实际生效的配置。

2. 通过Airflow UI查看 #

登录Airflow管理界面，进入Admin -> Configurations页面，这里会展示所有当前运行时生效的配置，包括通过环境变量注入的内容。

3. 直接验证功能有效性 #

如果已经确认LOAD_EXAMPLES=false生效（GUI无示例DAG）、EmailOperator能正常发送邮件，这些实际功能表现本身就是配置生效的最直接证明，无需依赖命令行输出。

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