Hibernate中CONCAT_WS遇null字段返回null问题求助

这个问题我之前帮同事排查过，核心原因其实是JPQL和原生SQL对CONCAT_WS的处理逻辑不一样——你以为是CONCAT_WS没按特性忽略null，但实际上是Hibernate在解析JPQL时，先尝试访问关联对象的属性（比如actItemId.actId.actNumber），如果actId本身是null，这个属性访问会直接导致整个拼接片段变成null，而非传给CONCAT_WS去处理。下面给你几个靠谱的解决方案：

方案1：用COALESCE包装可能为null的关联属性 #

这是最直接的JPQL层面解决方案，用COALESCE函数把可能为null的属性（包括关联对象为null导致的属性访问失败）替换为空字符串，这样CONCAT_WS就能正常忽略空值或者拼接其他字段了。

修改后的JPQL片段示例：

WHERE CONCAT_WS("_", 
    COALESCE(actItemId.actId.actNumber, ''), 
    DATE_FORMAT(recordDate, '%d.%m.%Y'), 
    COALESCE(actItemId.technicalField, '') -- 替换成你实际的techni...字段
) LIKE CONCAT('%', :searchValue, '%')

解释：COALESCE会返回传入参数中的第一个非null值，如果actItemId.actId是null，actItemId.actId.actNumber会被视为null，此时COALESCE会返回空字符串，CONCAT_WS就能正常处理其他非null的字段，不会因为某一个null片段导致整个拼接结果为null。

方案2：改用原生SQL查询 #

如果JPQL的处理逻辑让你头疼，直接用Hibernate的原生SQL查询，让数据库层面的CONCAT_WS函数直接处理null值（数据库的CONCAT_WS确实会忽略null字段）。

示例代码：

String nativeSql = "SELECT * FROM your_table_name t " +
                   "WHERE CONCAT_WS('_', " +
                   "    t.act_item_id_act_id_act_number, " +
                   "    DATE_FORMAT(t.record_date, '%d.%m.%Y'), " +
                   "    t.act_item_id_technical_field " +
                   ") LIKE ?";

Query query = entityManager.createNativeQuery(nativeSql, YourEntity.class);
query.setParameter(1, "%" + searchValue + "%");
List<YourEntity> results = query.getResultList();

注意：要把SQL中的字段名换成你数据库表的实际列名，确保和实体映射一致。

方案3：Hibernate 6+ 可使用IFNULL函数 #

如果你用的是Hibernate 6及以上版本，也可以用IFNULL函数（部分数据库如MySQL支持）替代COALESCE，效果完全一致：

WHERE CONCAT_WS("_", 
    IFNULL(actItemId.actId.actNumber, ''), 
    DATE_FORMAT(recordDate, '%d.%m.%Y'), 
    IFNULL(actItemId.technicalField, '')
) LIKE '%:searchValue%'

额外注意事项 #

• 要确保所有可能出现null的关联属性都被COALESCE或IFNULL包装，包括那些中间关联对象可能为null的情况（比如actItemId本身也可能为null的话，也要包装actItemId的属性）。
• 测试时一定要专门找带有null关联的记录，验证拼接后的结果是否符合预期，确保模糊搜索能正常匹配到这些记录。

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