lucene 8.x 不直接支持 float/double 类型的索引，因其二进制表示存在精度问题；推荐方案是将浮点数按需缩放为 long 类型后使用 numericdocvaluesfield 存储，兼顾精度控制与查询性能。
lucene 8.x 不直接支持 float/double 类型的索引，因其二进制表示存在精度问题；推荐方案是将浮点数按需缩放为 long 类型后使用 numericdocvaluesfield 存储，兼顾精度控制与查询性能。
在 Lucene 8.11（兼容 Java 8）中，NumericDocValuesField 确实仅接受 int 或 long 类型，而原生不提供 float/double 的直接索引支持。这并非设计疏漏，而是出于对数值精度、排序一致性及范围查询可靠性的严格考量——IEEE 754 浮点数在二进制存储中存在舍入误差，直接索引可能导致排序错乱或范围查询结果不可预期。
✅ 正确做法：缩放转换 + long 存储
将浮点值乘以合适倍数（如 10³、10⁶），转为 long 后写入 NumericDocValuesField。缩放因子决定了你保留的小数位数（即精度）：
double originalValue = 123.456789;
int scale = 1000; // 保留 3 位小数
long scaledValue = Math.round(originalValue * scale); // 注意使用 Math.round 避免截断误差
document.add(new NumericDocValuesField("price", scaledValue));
? 查询时需同步缩放条件：
若要查找 [123.45, 123.46] 区间内的价格，应转换为 long 范围查询：
double lower = 123.45;
double upper = 123.46;
long lowerLong = Math.round(lower * scale);
long upperLong = Math.round(upper * scale);
Query rangeQuery = LongPoint.newRangeQuery("price", lowerLong, upperLong);
⚠️ 注意事项：
-
精度取舍：选择缩放因子前需明确业务允许的最大误差（如
scale=100→ ±0.005 精度）； -
溢出防护：确保
originalValue * scale不超出Long.MAX_VALUE（建议对极端值做预校验）； -
排序与聚合：
NumericDocValuesField支持高效排序、分组和统计聚合（如min,max,sum），但结果需反向缩放还原：double restored = scaledValue / (double) scale； - 替代方案（不推荐）：使用
DoublePoint（Lucene 6.0+）虽支持 double 索引，但 Lucene 8.11 中DoublePoint仅用于Point查询（正向索引），不支持 DocValues 聚合/排序——而你的需求明确指向NumericDocValuesField场景，故缩放法仍是最佳实践。
总结：浮点数索引的本质是精度可控的整型映射。通过合理缩放、统一转换、同步查询，即可在 Lucene 8.11 中安全、高效地实现 float/double 值的存储、检索与分析。
