Spring Data JPA 如何实现多可选参数的动态条件查询？

以下是不同技术栈下的常用实现方案，可根据你的项目技术选型选择：

方案1：JPQL/原生SQL空值兼容写法（无额外依赖，适合参数较少的场景） #

不需要单独写多套查询语句，直接在原有查询条件中新增空值判断即可，参数为null时对应条件会自动失效：

@Query("select d from Data d where (:name is null or d.name = :name) and (:age is null or d.age = :age) and (:date is null or d.date = :date)")

如果业务中空字符串也属于无效查询条件，可以在判断里追加空字符串的校验逻辑即可，原生SQL的写法和上述逻辑完全一致。

方案2：Query By Example (QBE) （Spring Data JPA自带，适合简单等值查询场景） #

Spring Data JPA自带的动态查询能力，不需要手写任何查询语句，默认会自动忽略实体中的null字段作为查询条件：

• 构造查询模板实体，仅给需要过滤的字段赋值，可选字段留空
• 构建Example规则对象，默认自带忽略null值的匹配规则
• 直接调用JpaRepository内置的findAll(Example example)方法执行查询
  代码示例：

// 构造查询模板，仅设置需要过滤的字段，age、date留空会自动跳过过滤
Data queryTemplate = new Data();
queryTemplate.setName("张三");
Example<Data> example = Example.of(queryTemplate);
List<Data> result = dataRepository.findAll(example);

该方案的优势是完全不需要写查询语句，新增参数不用修改任何查询逻辑，缺点是默认不支持范围查询、模糊查询等非等值场景，适合全等值过滤的简单查询。

方案3：QueryDSL/JPA Criteria API（适合复杂查询、参数较多的场景） #

如果有6-7个可选参数、且存在范围查询、模糊查询、排序等复杂逻辑，推荐使用QueryDSL，通过流式API动态拼接查询条件，不会出现条件组合爆炸的问题：

// QData是QueryDSL自动生成的查询实体类
QData qData = QData.data;
BooleanBuilder conditionBuilder = new BooleanBuilder();
// 动态拼接条件，参数为空就不拼接对应规则
if (name != null) {
    conditionBuilder.and(qData.name.eq(name));
}
if (age != null) {
    conditionBuilder.and(qData.age.eq(age));
}
if (date != null) {
    conditionBuilder.and(qData.date.eq(date));
}
List<Data> result = queryFactory.selectFrom(qData).where(conditionBuilder).fetch();

该方案灵活度最高，支持所有SQL查询场景，新增参数只需要加一行判断逻辑即可，维护成本极低，缺点是需要提前引入QueryDSL依赖做简单配置。

方案4：MyBatis动态标签（适合MyBatis技术栈场景） #

如果项目用的是MyBatis，直接用自带的动态SQL标签即可实现：

<select id="listData" resultType="com.example.Data">
    select * from data
    <where>
        <if test="name != null">and name = #{name}</if>
        <if test="age != null">and age = #{age}</if>
        <if test="date != null">and date = #{date}</if>
    </where>
</select>

<where>标签会自动处理多余的and前缀，不需要额外处理SQL语法问题。

内容的提问来源于stack exchange，提问作者ima.technophyle