你遇到的问题其实是JPA Criteria API默认关联查询行为导致的——当你直接通过root.get("role").get("isMaster")访问关联属性时，JPA会自动使用内连接（Inner Join），这会提前过滤掉所有role为null的用户，所以哪怕你写了isNull条件也不会生效。

正确的解决方案 #

核心是先对role做左外连接（Left Outer Join），确保role为null的用户能被保留在查询结果中，再基于这个左连接对象构建条件。

完整代码示例如下：

// 1. 创建User和Role的左外连接，保留role为null的用户
Join<User, Role> roleLeftJoin = root.join("role", JoinType.LEFT);

// 2. 构建两个条件：
//    - 条件1：用户没有角色（role为null）
Predicate noRole = cb.isNull(root.get("role"));
//    - 条件2：用户的角色不是主角色（isMaster不等于'Y'）
Predicate nonMasterRole = cb.notEqual(roleLeftJoin.get("isMaster"), "Y");

// 3. 用OR组合两个条件，得到最终查询条件
Predicate finalCondition = cb.or(noRole, nonMasterRole);

额外说明 #

如果你的Role实体中isMaster字段可能存在null值（而不是严格的'Y'/'N'），可以把第二个条件扩展为包含isMaster为null的情况，避免遗漏数据：

Predicate nonMasterRole = cb.or(
    cb.isNull(roleLeftJoin.get("isMaster")),
    cb.notEqual(roleLeftJoin.get("isMaster"), "Y")
);

这样就能准确筛选出所有无角色或者角色非主角色的用户了。

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