JPA CriteriaBuilder处理可空@ManyToOne关联模糊查询结果异常问题

问题根源 #

你原有写法中root.get("a").get("name")默认会生成INNER JOIN关联目标表，INNER JOIN要求外键非空且匹配对应表记录，只要aID或bID其中一个为null，整条X表记录就会被提前过滤，最终导致只有两个关联都非空的记录才会进入后续的条件匹配。

修复代码 #

你需要显式指定**左连接（LEFT JOIN）**来关联A、B表，即使关联外键为null，X表的记录也会被保留，后续再做模糊匹配判断即可：

import javax.persistence.criteria.Join;
import javax.persistence.criteria.JoinType;
import org.springframework.data.jpa.domain.Specification;

// 如果你使用Jakarta EE，将import替换为jakarta.persistence对应包即可
public static Specification<X> filterName(String value) {
    return (root, query, builder) -> {
        if (value.isEmpty()) {
            return null;
        }
        // 显式声明左连接关联A、B实体
        Join<X, A> aJoin = root.join("a", JoinType.LEFT);
        Join<X, B> bJoin = root.join("b", JoinType.LEFT);

        // 分别构造两个关联的模糊匹配条件
        Predicate aNameMatch = builder.like(aJoin.get("name").as(String.class), "%" + value + "%");
        Predicate bNameMatch = builder.like(bJoin.get("name").as(String.class), "%" + value + "%");

        // 用or拼接两个条件，任意一个匹配即命中
        return builder.or(aNameMatch, bNameMatch);
    };
}

效果验证 #

针对你提供的示例数据，搜索关键词为%Lu%时，返回结果如下：

• X表ID=1：左连接A表无匹配，B表name=Luke匹配，命中
• X表ID=2：左连接B表无匹配，A表name=John不匹配，不命中
• X表ID=3：A表name=Lucy匹配，命中
  完全符合你期望的返回ID为1、3的结果。

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