Lucene 原生不支持直接索引 float/double 类型，因其二进制表示存在精度不确定性；推荐方案是将浮点数按需缩放为 long 后使用 NumericDocValuesField 存储，并在查询时做逆向换算。
lucene 原生不支持直接索引 float/double 类型，因其二进制表示存在精度不确定性；推荐方案是将浮点数按需缩放为 long 后使用 `numericdocvaluesfield` 存储，并在查询时做逆向换算。
在 Lucene 8.11（适配 Java 8）中，NumericDocValuesField 确实仅接受 int 或 long 类型，而未提供 float/double 的原生字段类。这是 Lucene 的有意设计：浮点数的 IEEE 754 表示具有舍入误差，直接用于排序、范围查询或聚合可能导致不可靠结果。因此，官方推荐采用确定性缩放（scaling）+ 整型编码的方式实现高精度、可预测的浮点数值索引。
✅ 正确实践：缩放后转 long 存储
选择合适的缩放因子（scale factor）是关键——它决定了你保留的小数位数。例如，若需保留 3 位小数，则乘以 1000；若需支持更大范围且避免溢出，可结合 Math.round() 提升鲁棒性：
double originalValue = 123.456789;
int scale = 1000; // 保留三位小数
long scaledValue = Math.round(originalValue * scale); // 推荐用 round 而非强制截断
Document doc = new Document();
doc.add(new NumericDocValuesField("price", scaledValue));
doc.add(new StoredField("price", originalValue)); // 可选：同时存储原始值便于展示⚠️ 注意事项：
- 溢出防护：确保
originalValue * scale不超出long范围（±9.2×10¹⁸）。对极大或极小浮点数，应先校验或改用BigDecimal预处理。- 查询一致性：检索时必须使用相同缩放逻辑。例如，查找
[123.45, 123.46]区间，需转换为long范围：Query rangeQuery = LongPoint.newRangeQuery("price", Math.round(123.45 * 1000), Math.round(123.46 * 1000) );- 排序与聚合：
NumericDocValuesField支持按字段值排序和DocValuesStats聚合，但所有计算均基于缩放后的整型值，结果需手动反向还原（如除以1000.0）。
✅ 补充建议
- 若需全文检索中的浮点语义（如“接近 123.45”），可额外添加
DoublePoint字段（Lucene 6.0+ 支持，但注意 Lucene 8.11 中DoublePoint已弃用，应改用LongPoint+ 缩放）； - 对于高精度科学计算场景，建议在应用层统一使用
BigDecimal进行缩放与反算，规避double本身精度缺陷； - 所有缩放逻辑建议封装为工具方法，确保索引与查询端严格一致。
通过这一模式，你既能兼容 Lucene 8.11 的类型约束，又能获得稳定、可复现、高性能的浮点数值检索能力。
