如何在JPQL查询中设置可选参数？避免多重if-else判断

嘿，这个问题我熟！你现在遇到的是JPQL可选参数筛选的经典问题——硬编码的WHERE条件会在参数为null时导致查询异常，而且不想写一堆if-else对吧？我给你几个实用的方案，都能完美解决这个问题：

这个方法最直接，我们只给非null的参数添加对应的查询条件，避免无效的= null判断：

public List<Moneda> filtradoMonedas(Divisa divisa, BigDecimal cantidad, BigDecimal ano) {
    EntityManager em = getEntityManager();
    // 用1=1作为基础条件，方便后续拼接AND子句，不会出现语法错误
    StringBuilder jpql = new StringBuilder("SELECT m FROM Moneda m WHERE 1=1");
    Map<String, Object> params = new HashMap<>();

    // 逐个检查参数，非null就添加条件和参数
    if (divisa != null) {
        jpql.append(" AND m.divisa = :divisa");
        params.put("divisa", divisa);
    }
    if (cantidad != null) {
        jpql.append(" AND m.cantidad = :cantidad");
        params.put("cantidad", cantidad);
    }
    if (ano != null) {
        jpql.append(" AND m.ano = :ano");
        params.put("ano", ano);
    }

    Query consulta = em.createQuery(jpql.toString());
    // 批量设置参数
    params.forEach(consulta::setParameter);

    List<Moneda> filtradoMonedas = (List<Moneda>) consulta.getResultList();
    for (Moneda m : filtradoMonedas) {
        em.refresh(m);
    }
    em.close();
    return filtradoMonedas;
}

为什么这么做？

• 用1=1作为占位基础，后面不管加多少AND条件都不会出现语法错误（比如不会变成WHERE AND m.divisa = ...）
• 只处理非null的参数，自动忽略空值条件，不需要写9个if-else组合
• 用Map统一管理参数，避免重复调用setParameter的冗余代码

如果你想避免字符串拼接可能带来的拼写错误，Criteria API是更好的选择——它是类型安全的，编译时就能发现属性名写错的问题：

public List<Moneda> filtradoMonedas(Divisa divisa, BigDecimal cantidad, BigDecimal ano) {
    EntityManager em = getEntityManager();
    CriteriaBuilder cb = em.getCriteriaBuilder();
    CriteriaQuery<Moneda> cq = cb.createQuery(Moneda.class);
    Root<Moneda> root = cq.from(Moneda.class);
    
    // 收集所有有效查询条件
    List<Predicate> predicates = new ArrayList<>();

    if (divisa != null) {
        predicates.add(cb.equal(root.get("divisa"), divisa));
    }
    if (cantidad != null) {
        predicates.add(cb.equal(root.get("cantidad"), cantidad));
    }
    if (ano != null) {
        predicates.add(cb.equal(root.get("ano"), ano));
    }

    // 将条件设置到查询中
    cq.where(predicates.toArray(new Predicate[0]));
    TypedQuery<Moneda> query = em.createQuery(cq);

    List<Moneda> filtradoMonedas = query.getResultList();
    for (Moneda m : filtradoMonedas) {
        em.refresh(m);
    }
    em.close();
    return filtradoMonedas;
}

进阶优化：如果你的项目生成了JPA静态元模型（可以通过Hibernate插件自动生成），还能把root.get("divisa")改成root.get(Moneda_.divisa)，彻底避免字符串拼写错误。

如果你的项目用了Spring Data JPA，那可以直接用@Query结合SpEL表达式，一行搞定：

public interface MonedaRepository extends JpaRepository<Moneda, Long> {
    @Query("SELECT m FROM Moneda m WHERE " +
           "(?1 IS NULL OR m.divisa = ?1) AND " +
           "(?2 IS NULL OR m.cantidad = ?2) AND " +
           "(?3 IS NULL OR m.ano = ?3)")
    List<Moneda> filtradoMonedas(Divisa divisa, BigDecimal cantidad, BigDecimal ano);
}

原理：每个条件都判断参数是否为null，如果是null就返回true（相当于忽略这个条件），否则执行等值匹配。这种写法最简洁，几乎没有样板代码。

如果你的BigDecimal参数可能来自前端的空字符串，记得在方法入口处做预处理，把空字符串转成null，避免参数转换异常哦！

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