Apache Kyuubi Web UI 中 JDBC 引擎日志获取异常问题分析

Apache Kyuubi 作为开源的大数据 SQL 网关，其 Web UI 提供了便捷的 SQL 编辑和执行功能。近期在使用过程中发现，当用户选择 JDBC 引擎执行查询时，Web UI 的 SQL 编辑器模块会出现异常，提示"Get SQL Log Failed"错误。

问题现象

在 Kyuubi Web UI 的 SQL 编辑器中选择 JDBC 引擎后，执行查询操作时前端界面会显示错误提示。通过浏览器开发者工具查看，发现是后端接口返回了 500 错误，具体表现为获取操作日志时抛出了 NullPointerException。

问题根源

经过深入分析，发现问题出在 Kyuubi 服务器的 OperationsResource 组件中。当使用 JDBC 引擎并以同步模式(runAsync=false)执行查询时，服务器端会返回一个空的 RowSet 对象。而在 OperationsResource.getOperationLog 方法中，代码直接调用了 rowSet.getColumns() 方法，没有对返回结果进行空值检查，导致了空指针异常。

技术细节

在 Kyuubi 的架构设计中，操作日志的获取分为两种模式：

1. 异步模式(runAsync=true)：服务器会维护操作日志
2. 同步模式(runAsync=false)：直接从引擎获取日志

对于 JDBC 引擎，在同步模式下执行查询时，虽然 KyuubiOperationManager 已经实现了从引擎获取日志的逻辑，但由于 JDBC 引擎的特殊性，返回的 RowSet 对象中 columns 字段为 null，而代码中没有对此情况进行处理。

解决方案

针对这个问题，社区已经提出了修复方案，主要改进点包括：

1. 在 OperationsResource.getOperationLog 方法中添加对 rowSet 和 getColumns() 返回值的空值检查
2. 当检测到空值时，返回适当的默认值或空列表，而不是抛出异常
3. 对于 JDBC 引擎的特殊情况，考虑是否需要在引擎层面提供日志支持

影响范围

该问题主要影响以下场景：

• 使用 Kyuubi Web UI
• 选择 JDBC 引擎类型
• 执行同步查询操作

对于其他引擎类型(如 Spark)或异步查询模式不受此问题影响。

总结

这个问题揭示了 Kyuubi 在异常处理方面的不足，特别是在处理不同引擎返回结果时的健壮性问题。通过这次修复，不仅解决了 JDBC 引擎日志获取的问题，也为后续支持更多引擎类型提供了更好的错误处理范例。对于使用者来说，升级到包含此修复的版本后，将获得更稳定的 Web UI 操作体验。