Airflow 2.4.0分布式Docker部署下已更新airflow.cfg仍出现DeprecationWarning的原因排查

这是个典型的Airflow版本迭代中的配置兼容问题，结合你用官方Docker镜像的场景，我来帮你理清原因和解决方向：

为什么明明airflow.cfg是最新配置，还是会出现警告？ #

官方Airflow Docker镜像的配置加载优先级是：环境变量 > 挂载的自定义airflow.cfg > 镜像默认配置。你检查的容器内airflow.cfg可能是镜像根据环境变量自动生成的，但你的.env文件里还在使用旧版本的配置变量名，Airflow读取到这些旧环境变量后，就会触发弃用警告，哪怕airflow.cfg里已经是新配置。

逐个拆解警告原因 #

1. sql_alchemy_conn从[core]移到[database]的警告 #

/home/airflow/.local/lib/python3.7/site-packages/airflow/configuration.py:545: DeprecationWarning: The sql_alchemy_conn option in [core] has been moved to the sql_alchemy_conn option in [database] - the old setting has been used, but please update your config.
这个警告说明你的.env里还在使用旧的环境变量AIRFLOW__CORE__SQL_ALCHEMY_CONN，而Airflow 2.x已经把数据库连接配置移到了[database] section，对应的环境变量应该是AIRFLOW__DATABASE__SQL_ALCHEMY_CONN。

2. auth_backend重命名为auth_backends的警告 #

/home/airflow/.local/lib/python3.7/site-packages/airflow/configuration.py:545: DeprecationWarning: The auth_backend option in [api] has been renamed to auth_backends - the old setting has been used, but please update your config.
同理，你的.env里可能还设置了AIRFLOW__API__AUTH_BACKEND，而Airflow 2.x已经将这个配置项重命名为auth_backends，对应的环境变量是AIRFLOW__API__AUTH_BACKENDS。

3. auth_backends需要包含session认证后端的FutureWarning #

/home/airflow/.local/lib/python3.7/site-packages/airflow/configuration.py:367: FutureWarning: The auth_backends setting in [api] has had airflow.api.auth.backend.session added in the running config, which is needed by the UI. Please update your config before Apache Airflow 3.0.
这个警告是因为当前auth_backends的配置里没有包含airflow.api.auth.backend.session，Airflow自动帮你添加了这个值以保证UI正常工作，但提醒你在Airflow 3.0前手动配置，避免兼容性问题。

解决步骤 #

1. 更新你的.env文件，替换旧的环境变量：
   • 把AIRFLOW__CORE__SQL_ALCHEMY_CONN替换为AIRFLOW__DATABASE__SQL_ALCHEMY_CONN
   • 把AIRFLOW__API__AUTH_BACKEND替换为AIRFLOW__API__AUTH_BACKENDS，并设置包含session后端的值，例如：

     AIRFLOW__API__AUTH_BACKENDS = airflow.api.auth.backend.basic_auth,airflow.api.auth.backend.session
     

2. 重启所有Airflow容器，让新的环境变量生效：

   docker-compose down && docker-compose up -d
   

3. 验证配置：登录任意Airflow容器，运行以下命令确认配置已更新：

   # 检查数据库连接配置
   airflow config get-value database sql_alchemy_conn
   # 检查API认证后端配置
   airflow config get-value api auth_backends
   

   此时再操作应该就不会出现这些警告了。

注意：不要直接修改容器内的airflow.cfg，因为容器重启后这个文件会被镜像重新生成，所有修改都会丢失。官方Docker镜像推荐通过环境变量来管理Airflow配置，这也是分布式环境下保持配置一致的最佳实践。

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