Apache Druid 30.0.0版本中MV_CONTAINS函数空指针异常问题解析

问题背景

在Apache Druid 30.0.0版本升级过程中，用户发现原本在29.0.0版本中正常工作的MV_CONTAINS函数开始出现NullPointerException异常。该问题在使用JSON_QUERY_ARRAY函数提取嵌套JSON数组并与MV_CONTAINS函数结合使用时尤为明显。

技术分析

根本原因

该问题的根源在于Druid 30.0.0对ARRAY_CONTAINS表达式(同时支持ARRAY_CONTAINS和MV_CONTAINS SQL函数)的优化处理。当处理复杂类型时，特别是与JSON_QUERY_ARRAY函数结合使用时，类型推断逻辑存在缺陷。

具体来说，JSON_QUERY_ARRAY函数提取的数组元素类型被标记为COMPLEX，而优化路径尝试将右侧参数强制转换为数组元素类型时，由于类型不匹配导致空指针异常。

解决方案对比

1. 临时解决方案：修改查询语句，使用更优化的ARRAY_CONTAINS和JSON_VALUE组合：

SELECT
  ARRAY_CONTAINS(JSON_VALUE(agent, '$.type' RETURNING VARCHAR ARRAY), 'Browser')
FROM "kttm_nested_1"

2. 永久修复方案：修改Function.java中的类型检查逻辑，确保在遇到非原始类型或非原始类型数组时跳过优化路径：

if (lhsType == null || !(lhsType.isPrimitive() || lhsType.isPrimitiveArray())) {
  return this;
}

最佳实践建议

1. 函数选择：对于JSON数组操作，优先使用ARRAY_系列函数而非MV_系列函数。MV_函数主要针对Druid早期的多值字符串列设计。

2. JSON处理优化：尽可能使用JSON_VALUE而非JSON_QUERY/JSON_QUERY_ARRAY，因为前者可以利用Druid 28+版本中对嵌套数组的特殊优化存储格式。

3. 版本兼容性：注意Druid 28+版本对嵌套数组存储格式的改进，旧版本创建的段可能需要回退到原始JSON处理方式。

影响范围

该问题不仅影响MV_CONTAINS函数，同样会影响array_overlap函数，因为它们共享相似的优化路径。开发团队需要对相关函数进行统一修复。

总结

这次版本升级暴露出的问题提醒我们，在使用复杂类型处理函数时需要特别注意类型系统的隐式转换。Druid社区已经识别出问题根源并提出了修复方案，用户可以通过调整查询语句或等待官方补丁来解决此问题。对于性能敏感的场景，采用JSON_VALUE的优化路径是更推荐的做法。