Spring Data Cassandra：仅当参数非空时执行WHERE子句

这个问题我之前做项目时也碰到过——Cassandra本身的CQL语法不像SQL那样支持直接写WHERE (:param IS NULL OR column = :param)这类条件式子句（主要是因为Cassandra的查询依赖分区键/聚类键的约束，随意的条件会触发全表扫描，性能很差），不过Spring Data Cassandra提供了几种实用的方案来实现你要的「参数为null时忽略WHERE子句」的需求，我给你逐一说明：

1. 用QueryBuilder手动构建动态查询 #

这是最灵活的方式，完全由你控制查询语句的拼接逻辑，适合复杂的条件场景。比如：

@Autowired
private CassandraOperations cassandraOps;

public List<Report> getReports(String param1) {
    // 初始化基础查询：查询Report表所有字段
    Select selectQuery = QueryBuilder.select().from("Report");
    
    // 如果param1不为null，添加WHERE条件
    if (param1 != null) {
        // 这里注意：你的原@Query写法有点歧义，假设你是要匹配「param1列等于'test'」？
        // 如果是参数值等于'test'，那应该是eq("param1", param1)，可根据实际需求调整
        selectQuery.where(QueryBuilder.eq(param1, "test"));
    }
    
    // 执行查询并返回结果
    return cassandraOps.select(selectQuery, Report.class);
}

这种方式逻辑清晰，你可以根据多个参数的null情况自由组合条件，完全避免语法错误。

2. 使用Spring Data的Example查询 #

如果你的查询只是简单的相等匹配，Spring Data的Example查询会自动忽略实体中为null的属性，非常省心。举个例子：

首先确保你的Repository继承CassandraRepository：

public interface ReportRepository extends CassandraRepository<Report, String> {
    List<Report> findAll(Example<Report> example);
}

然后调用的时候：

// 创建一个查询探针（probe）
Report probe = new Report();
// 只有当param1不为null时，设置对应的属性值（这里假设你要匹配param1列等于'test'）
if (param1 != null) {
    probe.setParam1("test");
}
// 构建Example对象，自动忽略null属性
Example<Report> queryExample = Example.of(probe);
// 执行查询
List<Report> result = reportRepository.findAll(queryExample);

这种方式代码简洁，适合简单的单条件或多条件相等查询，不用写任何CQL语句。

3. 在@Query中结合SpEL表达式动态拼接 #

如果你还是想保留@Query注解的方式，可以用Spring的SpEL表达式来动态生成查询语句。比如：

@Query("SELECT * FROM Report #{'?0 != null ? 'WHERE param1 = ''test''' : ''}")
List<Report> findByParam1(@Param("param1") String param1);

这里的SpEL表达式#{'?0 != null ? 'WHERE param1 = ''test''' : ''}会判断第一个参数（?0）是否为null：如果不为null，就拼接WHERE param1 = 'test'子句；如果为null，就只执行SELECT * FROM Report。

不过要注意字符串转义的问题——CQL里的单引号需要用两个单引号来转义，而且这种方式在多参数场景下会变得很繁琐，容易出错，所以更适合简单的单条件场景。

重要提醒 #

Cassandra是分布式数据库，全表扫描（也就是当param1为null时的查询）性能很差，除非你的数据量很小，否则不建议频繁这么做。如果这类查询是业务刚需，最好调整你的数据模型（比如增加合适的分区键），避免依赖全表扫描。实在要做的话，可能需要加上ALLOW FILTERING，但这个选项会强制Cassandra扫描所有节点的数据，生产环境一定要谨慎使用。

内容的提问来源于stack exchange，提问作者Sebastian G.