Redisson处理Redis Search索引信息解析异常问题分析

问题背景

在使用Redisson客户端(3.31.0版本)与Redis(7.2.4版本)交互时，当执行获取Search索引信息的操作时，系统抛出了NumberFormatException异常。具体错误信息显示，系统无法将字符串"15.182429313659668"转换为Long类型数值。

异常原因分析

通过异常堆栈可以清晰地看到问题根源：Redisson的IndexInfoDecoder在解析Redis返回的索引信息时，尝试将"offset_bits_per_record_avg"字段的值(15.182429313659668)转换为Long类型，而实际上这是一个浮点数。

Redis Search模块返回的索引统计信息中，许多指标都是以浮点数形式提供的，例如：

• inverted_sz_mb
• vector_index_sz_mb
• records_per_doc_avg
• bytes_per_record_avg
• offset_bits_per_record_avg等

然而Redisson客户端的IndexInfoDecoder在处理这些字段时，统一使用了Long.valueOf()方法进行转换，这显然与实际情况不符。

技术细节

在Redis Search的FT.INFO命令返回结果中，索引统计信息包含多种数据类型：

• 整数类型：如num_docs、max_doc_id等
• 浮点类型：如inverted_sz_mb、offset_bits_per_record_avg等
• 布尔类型：如indexing、cleaning等

IndexInfoDecoder原本的设计假设所有数值字段都是整数类型，这在早期版本中可能适用，但随着Redis Search功能的增强，越来越多的统计指标采用了浮点数表示，以提供更精确的度量。

解决方案

Redisson开发团队已经修复了这个问题，主要修改包括：

1. 在IndexInfoDecoder中，对于已知的浮点数字段，使用Double.parseDouble()替代Long.valueOf()
2. 更新相关实体类的字段类型，将部分字段从long改为double

这种修改既保持了向后兼容性，又能正确处理Redis返回的各种数值类型。

最佳实践建议

对于使用Redisson与Redis Search交互的开发者，建议：

1. 及时升级到修复后的Redisson版本
2. 在处理索引统计信息时，注意区分整数和浮点数字段
3. 对于自定义的索引信息解析逻辑，应当考虑所有可能的数值类型
4. 在异常处理中加入对NumberFormatException的捕获和适当处理

总结

这个问题的出现展示了开源生态中组件协同工作的复杂性。随着Redis功能的不断丰富，客户端也需要相应地进行适配和更新。Redisson团队快速响应并修复了这个问题，体现了开源社区的高效协作精神。对于开发者而言，保持对依赖库版本的关注并及时更新，是避免类似问题的有效方法。