Airflow 1.10.9迁移至1.10.13rc1后DAG删除REST API报404错误咨询
问题描述
从Airflow 1.10.9版本迁移至1.10.13rc1版本后,原有删除DAG的REST API调用直接失效,之前一直在用的调用命令为:curl --location --request DELETE '/api/experimental/dags/<dag_id>'
执行该请求时持续返回404错误,翻遍官方文档也没找到明确标注的DAG删除专用API的说明,需要对应的排查方向和解决方法。
报错根因
出现404的核心原因是版本迭代中对实验性API的路由规则做了调整,和权限、认证没有关系:
- 1.10.9及更早版本挂在
/api/experimental/dags/<dag_id>路径下的DELETE方法,从1.10.10版本开始就已经被移除,开发团队当时正在搭建稳定版v1 API的路由框架,为了避免实验性接口和后续正式接口的规则冲突,直接把原来的DELETE路由下掉了 - 1.10.13rc1作为预发布候选版本,出于安全考虑默认强化了实验性API的开启校验,不少用户升级过程中会把
enable_experimental_api配置项设为False,就算路径写对了也会因为路由没加载直接返回404 - 这个版本阶段Airflow的稳定v1 API还没合入完整的DAG删除能力,所以公开文档里根本找不到对应的正式接口说明
需要特别说明的是,这个报错是404路由不存在,不是403权限校验失败,别在认证配置、权限白名单上浪费时间排查。
可直接落地的解决方案
- 修正实验性API的请求方法与路径,匹配当前版本的路由规则
原来的DELETE方法被移除后,对应的实验性删除接口调整为POST方法指向的子路径,正确的调用命令为:curl --location --request POST '/api/experimental/dags/<dag_id>/delete'
这个接口的内部逻辑和1.10.9版本的原DELETE接口完全一致,接口触发后会自动完成DAG元数据、关联任务运行记录、历史任务实例的数据库级清理,不需要额外传任何参数。 - 检查webserver配置,确认实验性API处于开启状态
如果按上面的路径调用还是返回404,就去airflow.cfg的[webserver]段找enable_experimental_api配置项,1.10.13rc1在配置里加了大段的安全风险提示,很多用户升级时为了安全会把这个值设为False,导致整个实验性API的路由都没加载到webserver里。确认配置值为True之后重启webserver组件即可恢复。 - 绕过webserver路由,用Airflow内部模块完成删除
如果不想开放有安全风险的实验性API,也可以直接调用Airflow内置的模型方法实现DAG删除,这部分逻辑和实验性API的底层实现完全一样,示例代码非常简单:
这个脚本只要在部署Airflow组件的环境上执行就行,完全不依赖webserver的接口路由规则,不会出现404的问题。from airflow.models import DAG # 替换为实际要删除的dag_id DAG.delete_dag(dag_id="<your_dag_id>")
踩坑提醒:1.10.13rc1属于预发布候选版本,API路由规则在后续正式版本里还可能调整,生产环境不建议长期依赖实验性接口做核心操作,避免后续升级出现兼容问题。
内容的提问来源于stack exchange,提问作者Vidya Shree
相关产品推荐
相关产品推荐

