Apache Airflow中email_on_failure与on_failure_callback的功能区别

二者核心定位与能力边界有明显区别，具体差异如下：

• 基础功能与定位不同
  • email_on_failure 是Airflow官方封装好的开箱即用布尔型开关，仅用于控制任务失败时，是否自动向预设收件人发送默认格式的失败告警邮件，无任何扩展能力。
  • on_failure_callback 是开放的失败回调钩子，支持传入任意自定义可执行方法作为参数，可实现任意失败后逻辑：包括发送自定义格式的邮件/短信/企业告警、写入专属日志库、自动触发兜底补偿任务、上报监控指标等，没有功能限制。
• 底层实现关联与优先级不同
  开启email_on_failure的本质，是Airflow自动为对应任务挂载了一个内置的发邮件专用失败回调，它本身就是基于回调机制实现的封装功能。二者同时配置时会独立并行执行，互不影响；单独关闭email_on_failure不会对你自定义的on_failure_callback逻辑产生任何干扰。
• 配置成本与适用场景不同
  • email_on_failure可直接在全局配置文件设置默认值，也可在单个DAG、单个任务层级单独覆写，无需额外开发代码，调整成本极低，适合仅需要基础邮件告警的场景。
  • on_failure_callback需要开发者先编写对应自定义逻辑，再显式挂载到DAG或任务配置中，也可通过DAG工厂等方式批量配置，灵活度极高，适合有定制化失败处理需求的场景。

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