Hibernate中链式处理多个可选查询参数的最优方案是什么？

你的这种字符串拼接方式确实容易出错，而且重复的条件判断显得冗余。下面是几种更简洁可靠的优化方案：

1. JPA Criteria API（推荐，无额外依赖） #

JPA标准的Criteria API通过编程方式动态构建查询，完全避免手动拼接JPQL字符串的问题，同时自动处理参数绑定，还能规避硬编码属性名带来的潜在错误：

CriteriaBuilder cb = entityManager.getCriteriaBuilder();
CriteriaQuery<AddressEntity> cq = cb.createQuery(AddressEntity.class);
Root<AddressEntity> address = cq.from(AddressEntity.class);

List<Predicate> predicates = new ArrayList<>();
if (!StringUtil.isNullOrEmpty(streetName)) {
    predicates.add(cb.equal(address.get("streetName"), streetName));
}
if (!StringUtil.isNullOrEmpty(houseNumber)) {
    predicates.add(cb.equal(address.get("houseNumber"), houseNumber));
}
if (!StringUtil.isNullOrEmpty(city)) {
    predicates.add(cb.equal(address.get("city"), city));
}
if (!StringUtil.isNullOrEmpty(countryCode)) {
    predicates.add(cb.equal(address.get("countryCode"), countryCode));
}

cq.where(cb.and(predicates.toArray(new Predicate[0])));
TypedQuery<AddressEntity> query = entityManager.createQuery(cq);
return query.getResultList();

如果使用JPA元模型，还能进一步实现完全类型安全的属性引用，彻底杜绝属性名拼写错误。

2. 使用QueryDSL（简化代码，需引入依赖） #

QueryDSL是一款第三方库，提供更简洁的类型安全查询构建API，能大幅减少样板代码：

先引入QueryDSL的JPA依赖，并生成实体对应的Q类，之后可以这样编写查询：

QAddressEntity address = QAddressEntity.address;
JPAQuery<AddressEntity> query = new JPAQuery<>(entityManager);

query.from(address)
    .where(
        StringUtil.isNullOrEmpty(streetName) ? null : address.streetName.eq(streetName),
        StringUtil.isNullOrEmpty(houseNumber) ? null : address.houseNumber.eq(houseNumber),
        StringUtil.isNullOrEmpty(city) ? null : address.city.eq(city),
        StringUtil.isNullOrEmpty(countryCode) ? null : address.countryCode.eq(countryCode)
    );

return query.fetch();

QueryDSL会在编译期校验属性名和参数类型，避免运行时出错，代码可读性也更强。

3. 改进原有JPQL拼接方式（兼容现有代码） #

如果不想更换API，可以优化原有的拼接逻辑，避免重复判断和手动截断多余的AND：

List<String> conditions = new ArrayList<>();
Map<String, Object> params = new HashMap<>();

if (!StringUtil.isNullOrEmpty(streetName)) {
    conditions.add("a.streetName = :streetName");
    params.put("streetName", streetName);
}
if (!StringUtil.isNullOrEmpty(houseNumber)) {
    conditions.add("a.houseNumber = :houseNumber");
    params.put("houseNumber", houseNumber);
}
if (!StringUtil.isNullOrEmpty(city)) {
    conditions.add("a.city = :city");
    params.put("city", city);
}
if (!StringUtil.isNullOrEmpty(countryCode)) {
    conditions.add("a.countryCode = :countryCode");
    params.put("countryCode", countryCode);
}

String jpql = "SELECT a from address a";
if (!conditions.isEmpty()) {
    jpql += " WHERE " + String.join(" AND ", conditions);
}

TypedQuery<AddressEntity> query = entityManager.createQuery(jpql, AddressEntity.class);
params.forEach(query::setParameter);

return query.getResultList();

这种方式用集合统一管理条件和参数，通过String.join自动拼接条件，不会出现多余的AND，也减少了重复的非空判断。

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