Querydsl SQL一对多关联投影嵌套列表对象异常问题

问题根源 #

Querydsl 默认不会自动聚合一对多关联的结果，直接查询会产生笛卡尔积，分组或直接投影时如果没用到正确的聚合方式，只会取到每组的第一条关联数据，导致嵌套列表只有单个元素。

方法一：用 Querydsl GroupBy.transform 做数据库层面聚合（推荐） #

这是 Querydsl 处理一对多嵌套集合的标准方式，通过分组+transform 实现关联数据的聚合：

QAccount account = QAccount.account;
QAccountSetting accountSetting = QAccountSetting.accountSetting;

// 构建查询并聚合
List<AccountDTO> accountList = queryFactory
    .select(account, accountSetting)
    .from(account)
    .leftJoin(account.settings, accountSetting) // 确保Q类中settings是正确的一对多关联
    .groupBy(account.id) // 按账户主键分组
    .transform(GroupBy.groupBy(account.id).list(
        Projections.bean(AccountDTO.class,
            account.id.as("id"),
            account.username.as("username"),
            // 聚合当前分组下的所有AccountSetting到List
            GroupBy.list(Projections.bean(AccountSettingDTO.class,
                accountSetting.id.as("id"),
                accountSetting.key.as("key"),
                accountSetting.value.as("value"))).as("settings")
        )
    ));

注意点：

• 确保 QAccount 类中 settings 是 ListPath 类型的一对多关联，比如：ListPath<QAccountSetting, AccountSetting> settings = ListPath.create("settings", QAccountSetting.class);
• 投影时的别名要和 AccountDTO、AccountSettingDTO 的字段名严格对应，或者确保DTO有对应的setter方法
• 导入正确的 GroupBy 类：com.querydsl.core.group.GroupBy

方法二：内存中手动聚合（简单场景适用） #

如果数据库层面聚合写法复杂，可以先查询出笛卡尔积结果，再用 Java Stream 在内存中分组：

QAccount account = QAccount.account;
QAccountSetting accountSetting = QAccountSetting.accountSetting;

// 先查询所有账户与设置的配对数据
List<Tuple> tuples = queryFactory
    .select(account, accountSetting)
    .from(account)
    .leftJoin(account.settings, accountSetting)
    .fetch();

// 先将设置按账户ID分组
Map<Long, List<AccountSettingDTO>> settingGroup = tuples.stream()
    .filter(tuple -> tuple.get(accountSetting) != null)
    .collect(Collectors.groupingBy(
        tuple -> tuple.get(account).getId(),
        Collectors.mapping(tuple -> {
            AccountSetting setting = tuple.get(accountSetting);
            AccountSettingDTO dto = new AccountSettingDTO();
            dto.setId(setting.getId());
            dto.setKey(setting.getKey());
            dto.setValue(setting.getValue());
            return dto;
        }, Collectors.toList())
    ));

// 转换为最终的AccountDTO列表
List<AccountDTO> result = tuples.stream()
    .map(tuple -> tuple.get(account))
    .distinct() // 去重重复的账户
    .map(acc -> {
        AccountDTO dto = new AccountDTO();
        dto.setId(acc.getId());
        dto.setUsername(acc.getUsername());
        // 给账户绑定对应的设置列表
        dto.setSettings(settingGroup.getOrDefault(acc.getId(), Collections.emptyList()));
        return dto;
    })
    .collect(Collectors.toList());

这种写法更直观，适合关联逻辑简单的场景，但数据量大时性能不如数据库层面聚合。

排查要点 #

1. 检查Q类关联配置：确保QAccount中的settings字段正确映射了数据库的一对多关联，没有配错关联字段或关联类型
2. 投影字段映射：AccountDTO的settings字段必须是List<AccountSettingDTO>类型，且投影时的别名as("settings")要和字段名一致
3. Querydsl版本适配：5.x版本的GroupBy API和旧版本有差异，避免混用旧版本的写法

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