如何在Spring中结合Specification与Criteria API使用SQL Server FREETEXT函数

你的代码问题出在直接调用了criteriaQuery.where()，这会覆盖后续生成的查询条件，而且没有把FREETEXT的逻辑和其他查询条件合并到同一个Predicate里。正确的做法是把FREETEXT生成的Predicate和现有的like条件组合起来，作为Specification的返回值，同时避免直接修改criteriaQuery的where子句。

另外，多表join后可能会出现重复结果，建议加上criteriaQuery.distinct(true)去重。

修正后的代码如下：

static Specification<HearingEntity> hasSearchTermEquals(String searchTerm) {
    return (root, criteriaQuery, criteriaBuilder) -> {
        // 关联相关表
        Join<HearingEntity, HearingSpeakerEntity> hearingSpeaker = root.join(HearingEntity_.speakers);
        Join<HearingSpeakerEntity, SpeakerEntity> speaker = hearingSpeaker.join(HearingSpeakerEntity_.speaker);
        Join<HearingEntity, StatementEntity> statement = root.join(HearingEntity_.statements);

        // 生成FREETEXT对应的Predicate
        Predicate freetextPredicate = criteriaBuilder.function(
                "FREETEXT", 
                Boolean.class, 
                statement.get(StatementEntity_.statementText), 
                criteriaBuilder.literal(searchTerm)
        );

        // 原有模糊匹配条件
        Predicate titleLike = criteriaBuilder.like(root.get(HearingEntity_.hearingTitle), "%" + searchTerm + "%");
        Predicate speakerLike = criteriaBuilder.like(speaker.get(SpeakerEntity_.fullName), "%" + searchTerm + "%");

        // 合并所有查询条件：FREETEXT匹配 或 标题匹配 或 发言人姓名匹配
        Predicate combinedPredicate = criteriaBuilder.or(freetextPredicate, titleLike, speakerLike);

        // 开启去重，避免多表关联导致的重复结果
        criteriaQuery.distinct(true);

        return combinedPredicate;
    };
}

关键说明： #

• 不再直接调用criteriaQuery.where()，而是将所有条件合并为一个Predicate返回，Spring Data JPA会自动把这个Predicate整合到最终查询的where子句中，完全兼容其他动态添加的Specification条件。
• FREETEXT函数生成的Predicate直接参与逻辑运算，最终生成的SQL会包含FREETEXT(statement_text, ?)的片段。
• 添加distinct(true)是因为多对多关联查询会产生重复的实体记录，去重后结果更准确。

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