Lucene中QueryWrapperFilter已弃用，数值范围过滤实现遇阻求助

嘿，这个问题我之前也踩过坑，Lucene把Filter体系整合进Query之后，老的写法确实容易绕晕，我来给你捋清楚怎么解决！

首先得明确核心变化：Lucene从5.x版本开始就逐步废弃了Filter接口，现在推荐用**带BooleanClause.Occur.FILTER子句的Query**来实现原来Filter的功能——既不影响文档评分，又能完成过滤逻辑，和原来的QueryWrapperFilter效果完全一致。

你提到的BooleanQuery构造器弃用的问题，现在Lucene要求用BooleanQuery.Builder这个构建器类来创建BooleanQuery，根本不需要额外的QueryBuilder实例，直接就能搞定。

给你写个适配过滤器工厂场景的完整示例代码：

public class CustomNumericRangeFilterFactory extends BaseFilterFactory {

    @Override
    public Query createFilter(SolrQueryRequest req) {
        // 从工厂初始化参数里获取数值范围配置，比如min、max
        String minStr = getInitArgs().get("min");
        String maxStr = getInitArgs().get("max");
        String targetField = getFieldName();

        // 根据字段类型创建对应NumericRangeQuery，这里用Long类型举例，可替换为Int/Double/Float
        NumericRangeQuery<Long> rangeQuery = NumericRangeQuery.newLongRange(
                targetField,
                minStr != null ? Long.parseLong(minStr) : null, // 最小值，null表示无下限
                maxStr != null ? Long.parseLong(maxStr) : null, // 最大值，null表示无上限
                true, // 是否包含最小值
                true  // 是否包含最大值
        );

        // 用BooleanQuery.Builder构建带FILTER子句的查询
        BooleanQuery.Builder filterQueryBuilder = new BooleanQuery.Builder();
        filterQueryBuilder.add(rangeQuery, BooleanClause.Occur.FILTER);

        // 返回最终查询，这就是替代原Filter的方案
        return filterQueryBuilder.build();
    }
}

这里几个关键点要注意：

• 彻底抛弃QueryWrapperFilter：直接用BooleanClause.Occur.FILTER把NumericRangeQuery标记为过滤查询，Lucene会自动按过滤逻辑处理，不会参与评分计算。
• 废弃构造器不用纠结：BooleanQuery.Builder是Lucene官方现在推荐的构建方式，比老构造器更灵活，还能避免参数错误。
• 适配字段类型：如果你的字段是整数、浮点数，记得换成NumericRangeQuery.newIntRange()、NumericRangeQuery.newDoubleRange()等对应方法。

另外，如果你的过滤器工厂原来继承的类要求返回Filter，说明依赖版本可能偏旧，建议升级到较新的Lucene/Solr版本——现在新版本的FilterFactory已经统一返回Query类型，这是官方的演进方向。

内容的提问来源于stack exchange，提问作者Joaquín L. Robles