Spring Data JPA关联实体按id与名称过滤查询实现方法咨询

以下两种方案均基于Spring Data JPA原生能力实现，可直接适配你定义的BaseRepository结构。

方案1：固定过滤条件用JPQL/查询派生 #

如果过滤参数是固定的，直接在UserRepository中定义查询方法即可：

// 首先定义UserRepository继承你封装的通用BaseRepository
public interface UserRepository extends BaseRepository<User> {
    // 方案1.1 Spring Data自动属性导航查询，自动生成关联逻辑
    // 注意：属性名需和实体定义完全一致，你定义的SystemManagerEntity属性为大写开头的SystemManagerName，需严格匹配
    List<User> findByIdAndSystemManagerEntity_SystemManagerName(Long userId, String systemManagerName);

    // 方案1.2 手动写JPQL，自主控制连接类型、是否抓取关联字段，避免懒加载N+1问题
    @Query("SELECT u FROM User u INNER JOIN FETCH u.systemManagerEntity sm WHERE u.id = :userId AND sm.SystemManagerName = :managerName")
    List<User> queryUserByIdAndManagerName(@Param("userId") Long userId, @Param("managerName") String managerName);
}

如果需要保留没有关联SystemManagerEntity的User数据，将JPQL中的INNER改为LEFT即可。

方案2：动态过滤条件用Specification实现 #

如果过滤参数是动态可选的，用Spring Data封装的Specification简化Criteria API开发：

1. 首先给UserRepository扩展JpaSpecificationExecutor能力：

public interface UserRepository extends BaseRepository<User>, JpaSpecificationExecutor<User> {
}

2. 编写查询条件构造逻辑：

public class UserSpecifications {
    public static Specification<User> filterByIdAndManagerName(Long userId, String managerName) {
        return (root, query, criteriaBuilder) -> {
            // 关联SystemManagerEntity
            Join<User, SystemManagerEntity> smJoin = root.join("systemManagerEntity", JoinType.INNER);
            List<Predicate> predicates = new ArrayList<>();
            // 按User id过滤，参数为空则不生效
            if (userId != null) {
                predicates.add(criteriaBuilder.equal(root.get("id"), userId));
            }
            // 按管理员名称过滤，参数为空则不生效
            if (managerName != null && !managerName.isBlank()) {
                predicates.add(criteriaBuilder.equal(smJoin.get("SystemManagerName"), managerName));
            }
            return criteriaBuilder.and(predicates.toArray(new Predicate[0]));
        };
    }
}

3. 调用查询：

@Autowired
private UserRepository userRepository;

// 传入动态参数查询
List<User> result = userRepository.findAll(UserSpecifications.filterByIdAndManagerName(1L, "管理员名称"));

注意事项 #

• 你定义的SystemManagerEntity中的属性名SystemManagerName不符合Java小驼峰命名规范，后续如果调整为小驼峰systemManagerName，所有查询中的属性名需要同步修改
• 如果需要按SystemManagerEntity的id过滤，只需要在条件中添加criteriaBuilder.equal(smJoin.get("id"), smId)即可
• 如果返回结果只需要id和名称两个字段，可以使用Spring Data JPA投影能力减少返回字段，优化查询性能

内容的提问来源于stack exchange，提问作者İlker çelimli