Apache Kyuubi 中 Spark History Server 显示不完整应用时的类型转换问题分析

问题背景

在 Apache Kyuubi 项目中，当用户通过 Spark History Server 查看不完整的应用程序时，会遇到一个类型转换异常。具体表现为访问 Kyuubi 查询引擎 UI 时出现 HTTP 500 错误，错误信息显示无法将 java.lang.Integer 转换为 java.lang.Long。

错误现象

用户在使用 Spark 3.3.2 版本时，通过 ApplicationMaster 直接访问 Kyuubi Query Engine 页面可以正常显示，但当通过 Spark History Server 查看"不完整应用"中的 Kyuubi Query Engine 时，会出现以下错误：

HTTP ERROR 500 java.lang.ClassCastException: java.lang.Integer cannot be cast to java.lang.Long

堆栈跟踪显示错误发生在 Spark UI 的 StatementStatsPagedTable.row 方法中，具体是在处理 EnginePage 相关数据时发生的类型转换问题。

问题根源

经过分析，这个问题与 Jackson 库在处理 Scala 类型时的行为有关。具体来说，当 Jackson 反序列化某些数值类型时，可能会将原本应为 Long 类型的值反序列化为 Integer 类型，从而导致后续的类型转换失败。

这个问题类似于 Jackson 模块中已知的一个问题，即在处理 Scala 集合和数值类型时可能出现的类型不匹配情况。

解决方案

针对这个问题，社区提出了两种解决方案：

1. 直接修改相关字段的类型定义，确保类型一致性
2. 使用 Jackson 的 @JsonDeserialize 注解显式指定反序列化类型

最终采用了第二种更为优雅的解决方案，即在 operationRunTime 和 operationCpuTime 字段上添加注解：

@JsonDeserialize(contentAs = classOf[java.lang.Long])

这个注解明确告诉 Jackson 在反序列化时将内容转换为 java.lang.Long 类型，从而避免了后续的类型转换异常。

技术意义

这个修复不仅解决了眼前的问题，还具有以下技术意义：

1. 增强了 Kyuubi 与 Spark History Server 的兼容性
2. 提供了更健壮的类型处理机制
3. 为类似的数据类型转换问题提供了参考解决方案

总结

在分布式系统和大数据处理框架中，类型系统的正确处理至关重要。Apache Kyuubi 作为 Spark SQL 的接口服务，需要确保在各种环境下都能正确处理数据类型。这次问题的解决展示了开源社区如何通过协作快速定位和修复复杂系统中的类型相关问题，提高了系统的稳定性和可靠性。