Java Spring Data Cassandra @Query实现可选参数LIKE查询方案

1. 能否通过@Query直接返回实体类 #

可以，只要你的Employee类已经添加了Spring Data Cassandra的@Table注解，字段和表列完成正确映射，调整返回类型即可。注意原写法中返回单个Employee不合理，LIKE模糊查询通常匹配多条结果，建议修改为List<Employee>，如果确定唯一匹配可使用Optional<Employee>。

2. 空参数报错的解决方法 #

报错原因是你当前写的静态查询强制要求两个LIKE条件都生效，当入参为空时，Cassandra会收到空的LIKE匹配值，触发LIKE value can't be empty的错误。你可以通过动态条件判断实现可选参数的过滤，修改后的@Query写法如下：

@Query("SELECT * FROM employee WHERE " +
  "(:email IS NULL OR :email = '' OR email LIKE CONCAT('%', :email, '%')) " +
  "AND (:firstName IS NULL OR :firstName = '' OR first_name LIKE CONCAT('%', :firstName, '%')) " +
  "ALLOW FILTERING")
List<Employee> search(@Param("email") String email, @Param("firstName") String firstName);

说明： #

• 条件(:email IS NULL OR :email = '' OR email LIKE ...)的逻辑是：当email参数为空值或空字符串时，跳过该过滤条件，只有参数非空时才执行LIKE匹配
• CONCAT('%', :email, '%')直接在SQL层拼接通配符，不需要在业务代码里手动加%
• 末尾的ALLOW FILTERING是Cassandra要求非索引字段过滤时必须添加的配置，如果email和first_name已经建了二级索引，可以去掉该配置
• 你也可以在业务层提前把空字符串参数转为null，简化SQL里的判断逻辑，去掉:email = ''的判断即可

可选优化方案 #

如果后续过滤条件会继续增加，也可以整合QueryBuilder和Spring Data的映射能力，执行查询后调用cassandraTemplate.select(select, Employee.class)直接返回映射后的实体列表，不需要手动解析Row：

Select select = QueryBuilder.select().from("employee");
Where selectWhere = select.where();
if (!email.isEmpty()) {
  selectWhere.and(QueryBuilder.like("email", "%" + email + "%"));
}
if (!firstName.isEmpty()) {
  selectWhere.and(QueryBuilder.like("first_name", "%" + firstName + "%"));
}
// 直接返回映射后的实体列表，无需手动解析Row
return cassandraTemplate.select(select, Employee.class);

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