Spring Boot 3 + Hibernate 6：如何对值对象执行聚合操作？

你的问题核心在于：值对象是自定义类型，直接查询时Hibernate能完成数据库字段到值对象的映射，但使用SUM()等聚合函数后，返回的是基础数值类型（如BigDecimal），Hibernate无法自动将这个基础类型转换回值对象，导致类型推断失败抛出NullPointerException。

以下是几种可行的解决方式：

方法1：调整DTO字段类型为基础数值类型 #

把DocumentsYearTypeSum中的sum字段类型从自定义值对象（比如Amount）改为对应的基础数值类型（比如BigDecimal），这样聚合函数的结果可以直接映射到DTO字段：

// 修改后的DocumentsYearTypeSum示例
public class DocumentsYearTypeSum {
    private Integer year;
    private String type;
    private BigDecimal sum; // 替换为基础类型，而非值对象

    // 对应的构造函数、getter/setter
}

此时原查询语句不需要修改，Hibernate能正常处理聚合结果的映射。

方法2：使用构造函数显式转换为值对象 #

如果必须在DTO中保留值对象类型，可以在JPQL查询中通过构造函数，将聚合后的基础数值传入值对象的构造函数，完成显式转换：
假设你的值对象Amount有接收BigDecimal的构造函数，且值对象内部的数值字段为value，查询语句可以修改为：

@Query("""
    SELECT NEW com.yourproject.dto.DocumentsYearTypeSum(
        r.year, 
        r.type, 
        NEW com.yourproject.valueobject.Amount(SUM(s.amount.value))
    )
    FROM Receipt r JOIN r.sumLines s 
    GROUP BY r.year, r.type
    ORDER BY r.year, r.type
    """)
List<DocumentsYearTypeSum> documentsByYearTypeSum();

这种方式需要确保值对象有对应的构造函数，且JPQL中能正确引用值对象的内部字段。

方法3：注册自定义类型转换器（进阶） #

如果需要全局支持基础类型到值对象的转换，可以通过Hibernate的TypeContributor或者JPA的@Converter来实现自定义类型转换，让Hibernate能自动将聚合后的基础类型转换为值对象。这种方式适合需要在多处使用该转换的场景，但配置相对复杂：

1. 实现AttributeConverter：

@Converter(autoApply = true)
public class AmountConverter implements AttributeConverter<Amount, BigDecimal> {
    @Override
    public BigDecimal convertToDatabaseColumn(Amount amount) {
        return amount != null ? amount.getValue() : null;
    }

    @Override
    public Amount convertToEntityAttribute(BigDecimal dbData) {
        return dbData != null ? new Amount(dbData) : null;
    }
}

2. 在值对象上标注@Convert（如果没设置autoApply=true）：

@Embeddable // 或者作为普通值对象
public class Amount {
    @Convert(converter = AmountConverter.class)
    private BigDecimal value;
    // 构造函数、getter等
}

完成配置后，Hibernate会自动处理聚合结果到值对象的转换。

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