Apache Kyuubi Web UI请求超时机制优化分析

背景概述

在Apache Kyuubi项目的Web UI界面中，当用户执行复杂SQL查询时，前端axios请求可能会在Spark任务仍在处理过程中就提前终止。这个问题源于前端代码中对axios请求设置了默认的超时限制（10秒），而大数据查询任务往往需要更长的执行时间。

问题根源

通过分析源码发现，Kyuubi的web-ui模块在utils/request.ts文件中硬编码了axios的默认超时配置：

const service = axios.create({
  timeout: 10000
})

这种实现方式存在两个主要问题：

1. 超时时间固定为10秒，无法适应不同复杂度的查询需求
2. 超时控制放在前端不够合理，应该由后端服务统一管理

技术影响

这种前端强制超时机制会导致：

• 长耗时查询被意外中断，影响用户体验
• 查询结果无法完整返回，造成数据不一致
• 开发人员难以根据实际业务需求调整超时策略

解决方案

经过社区讨论，最终采取的优化方案是：

1. 完全移除前端axios的超时设置
2. 将超时控制权交还给Kyuubi服务端
3. 由服务端根据查询复杂度动态调整超时策略

最佳实践建议

对于类似的大数据查询系统，建议：

1. 前端只负责展示层逻辑，不介入业务超时控制
2. 超时策略应该作为服务端可配置参数
3. 对于长查询可以提供进度反馈机制
4. 考虑实现查询结果缓存机制

总结

这次优化体现了分布式系统设计的一个重要原则：控制权应该放在最了解业务场景的组件中。对于Kyuubi这样的SQL网关服务，查询执行时间应该由服务端根据集群负载和查询复杂度动态决定，而不是在前端做硬编码限制。这种架构调整使得系统更加健壮和灵活，能够更好地适应不同规模的查询需求。