如何为JPA Repository添加枚举子串匹配的抽象查询方法？

你提到的直接用findByDepartmentContaining(String query)行不通，因为JPA自动生成查询的逻辑只支持对字符串、数字这类基础类型使用Containing模糊匹配关键字，枚举类型无法直接被解析为可模糊匹配的字符串。不过你的Department枚举是用@Enumerated(EnumType.STRING)存储的（数据库里实际存的是枚举常量的字符串名称，比如NORTH、SOUTH），可以通过以下几种方式实现需求：

方法一：自定义JPQL查询 #

直接在Repository里写JPQL语句，把枚举的字符串名称作为匹配目标，实现模糊查询：

@Repository
public interface PersonRepository extends CrudRepository<Person,String> {
    Optional<Person> findByFullName(String fullName);
    List<Person> findByDepartment(Department department);
    List<Person> findByFullNameContaining(String query);
    
    // 新增的枚举子串查询方法
    @Query("SELECT p FROM Person p WHERE p.department.name LIKE %:query%")
    List<Person> findByDepartmentContaining(@Param("query") String query);
}

说明 #

• p.department.name调用了枚举的name()方法，返回的就是枚举常量的字符串形式，和数据库存储的内容完全一致
• LIKE %:query%实现了子串匹配逻辑，效果和Containing完全相同
• 调用时直接传入子串即可，比如传"NOR"会匹配NORTH，传"OU"会匹配SOUTH

方法二：使用Criteria API动态构建查询 #

如果需要结合其他条件做更灵活的查询，可以用Criteria API实现：

@Repository
public interface PersonRepository extends CrudRepository<Person,String>, JpaSpecificationExecutor<Person> {
    // 保留原有方法...
}

// 在业务类中编写查询逻辑
public List<Person> findByDepartmentContaining(String query) {
    Specification<Person> spec = (root, queryObj, cb) -> {
        // 将枚举字段转换为字符串类型，再执行模糊匹配
        Expression<String> departmentStr = root.get("department").as(String.class);
        return cb.like(departmentStr, "%" + query + "%");
    };
    return personRepository.findAll(spec);
}

方法三：新增映射字符串字段（可选） #

可以在Person实体里新增一个和department对应字符串字段，映射同一个数据库列，之后直接对这个字段用Containing查询：

@Entity
@Table(name = "Person")
public class Person {
    // 原有字段...
    
    @Column(name = "department")
    @Enumerated(EnumType.STRING)
    @NotNull(message = "Department must be specified")
    private Department department = Department.UNKNOWN;
    
    // 新增字符串字段，仅用于查询，不参与插入和更新操作
    @Column(name = "department", insertable = false, updatable = false)
    private String departmentStr;
    
    // 原有getter/setter...
    public String getDepartmentStr() {
        return departmentStr;
    }

    public void setDepartmentStr(String departmentStr) {
        this.departmentStr = departmentStr;
    }
}

然后在Repository中添加方法：

List<Person> findByDepartmentStrContaining(String query);

这种方式更贴近你原本使用Containing的习惯，但会增加实体的冗余字段，适合简单场景。

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