QueryDSL BooleanExpression遇null字段时排除数据问题求助

算力阿峰

2026-6-27

解决QueryDSL中空关联字段导致的查询过滤问题

问题原因

你遇到的核心问题是：QueryDSL在访问关联属性qAdopt.owner.nickName时，默认会生成内连接（INNER JOIN）。内连接会自动剔除所有没有关联Owner的Adopt记录——哪怕这些Adopt的name、code等其他字段完全匹配查询条件。

解决方法

下面提供两种可靠的修复方案，都能保留按owner昵称过滤的功能，同时不丢失无Owner的Adopt记录：

方案1：显式使用左连接（推荐）

先通过左连接保留所有Adopt记录，再判断Owner是否存在后匹配昵称：

// 假设已定义QOwner实例：QOwner qOwner = QOwner.owner;

if (StringUtils.isNotBlank(query)){
    // 显式左连接Owner，确保无Owner的Adopt不被过滤
    query.leftJoin(qAdopt.owner, qOwner);
    
    expression = expression.and(
        qAdopt.name.containsIgnoreCase(query)
        .or(qAdopt.code.containsIgnoreCase(query))
        .or(qAdopt.specie.name.containsIgnoreCase(query))
        .or(qAdopt.specie.code.containsIgnoreCase(query))
        .or(qAdopt.rarity.stringValue().containsIgnoreCase(query))
        // 先判断Owner存在，再匹配昵称
        .or(qOwner.isNotNull().and(qOwner.nickName.containsIgnoreCase(query)))
    );
}

方案2：使用coalesce处理空值

通过coalesce将null的nickName转换为空字符串，避免触发内连接：

import static com.querydsl.core.types.dsl.Expressions.coalesce;

if (StringUtils.isNotBlank(query)){
    expression = expression.and(
        qAdopt.name.containsIgnoreCase(query)
        .or(qAdopt.code.containsIgnoreCase(query))
        .or(qAdopt.specie.name.containsIgnoreCase(query))
        .or(qAdopt.specie.code.containsIgnoreCase(query))
        .or(qAdopt.rarity.stringValue().containsIgnoreCase(query))
        // 将null的nickName转为空字符串，避免内连接过滤
        .or(coalesce(qAdopt.owner.nickName, "").containsIgnoreCase(query))
    );
}