Lucene日期过滤与多文本字段查询结合返回0分结果问题排查

核心问题 #

你遇到的0分无关文档，根源在于Lucene BooleanQuery的子句规则：
当你将文本查询设为SHOULD（可选匹配）、日期过滤设为FILTER（强制过滤但不参与打分）时，Lucene会返回所有满足FILTER条件的文档——哪怕没有任何SHOULD子句匹配，这类无匹配的文档分数就是0.0。

解决方案 #

要实现「必须匹配文本查询+满足日期过滤」的需求，有两种简洁的修正方式：

方式1：设置最小匹配数

在构建BooleanQuery时，强制要求至少有一个SHOULD子句（title或content）匹配：

private fun buildQuery(queryString: String, fromDate: String, toDate: String): Query {
    val booleanQuery = BooleanQuery.Builder()

    arrayOf("title", "content")
        .forEach { field ->
            booleanQuery.add(
                BoostQuery(TermQuery(Term(field, queryString)), 1.1f), BooleanClause.Occur.SHOULD
            )
        }
    // 关键：要求至少匹配一个文本字段
    booleanQuery.setMinimumNumberShouldMatch(1)

    val fromMillis = dateFormatter.parse(fromDate).time
    val toMillis = dateFormatter.parse(toDate).time
    val dateRangeQuery = LongPoint.newRangeQuery("updatedMillis", fromMillis, toMillis)
    booleanQuery.add(dateRangeQuery, BooleanClause.Occur.FILTER)

    return booleanQuery.build()
}

方式2：将文本查询设为必须条件

把多个文本字段的SHOULD查询包装成一个子查询，再将这个子查询设为MUST（必须匹配），日期过滤仍用FILTER：

private fun buildQuery(queryString: String, fromDate: String, toDate: String): Query {
    val mainQuery = BooleanQuery.Builder()

    // 构建文本匹配子查询：title或content至少一个匹配
    val textMatchQuery = BooleanQuery.Builder()
    arrayOf("title", "content")
        .forEach { field ->
            textMatchQuery.add(
                BoostQuery(TermQuery(Term(field, queryString)), 1.1f), BooleanClause.Occur.SHOULD
            )
        }
    textMatchQuery.setMinimumNumberShouldMatch(1)
    // 文本匹配是必须条件
    mainQuery.add(textMatchQuery.build(), BooleanClause.Occur.MUST)

    // 日期范围过滤
    val fromMillis = dateFormatter.parse(fromDate).time
    val toMillis = dateFormatter.parse(toDate).time
    val dateRangeQuery = LongPoint.newRangeQuery("updatedMillis", fromMillis, toMillis)
    mainQuery.add(dateRangeQuery, BooleanClause.Occur.FILTER)

    return mainQuery.build()
}

效果验证 #

修改后执行查询，只会返回同时满足以下两个条件的文档：

1. title或content字段包含ergonomic
2. updatedMillis在2024-04-09至2024-04-22范围内

不会再出现0分的无关结果。

内容的提问来源于stack exchange，提问作者user7858768