如何使用JPA Criteria API实现NOT IN查询排除指定ID的Agent实体

要排除ID在指定UUID集合中的Agent实体，以下是可靠的实现方案及说明：

推荐方案：使用in() + not() #

这是对应SQL中NOT IN语义最直接的实现方式，通过CriteriaBuilder的not()方法包裹in()表达式即可：

@Override
public Predicate toPredicate(Root<Agent> root, CriteriaQuery<?> query, CriteriaBuilder criteriaBuilder) {

    root.fetch(Agent_.TAGS, JoinType.LEFT);
    query.distinct(true);

    List<Predicate> predicateList = new ArrayList<>();

    if(!excludedAgents.isEmpty()){
        // 获取Agent的id字段表达式
        Expression<UUID> agentIdExpr = root.get(Agent_.id);
        // 构建NOT IN谓词：id不在excludedAgents集合中
        Predicate notInPredicate = criteriaBuilder.not(agentIdExpr.in(excludedAgents));
        predicateList.add(notInPredicate);
    }

    // 其他谓词逻辑...

    return criteriaBuilder.and(predicateList.toArray(new Predicate[0]));
}

关于isNotMember的说明 #

你提到的isNotMember方法不适用于当前场景，它的设计目的是判断某个元素是否不属于实体的集合属性（比如Agent有Set<Role>类型的roles属性时，判断某个Role不在该集合内），而非用于字段值的范围排除，因此这里不建议使用。

补充提示 #

• 若未使用JPA元模型，可直接用字符串字段名替代元模型引用：root.get("id")
• 保留excludedAgents非空判断，避免生成无效SQL语句

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