SortedSet搭配Hibernate的@SortNatural及Comparable从库中读取数据未排序

算力阿峰

2026-10-3

问题根因排查及解决方法

核心错误原因

你对TreeSet在JPA场景下的使用认知存在偏差：虽然JDK原生TreeSet本身只依赖compareTo方法判断元素相等与排序，但Hibernate处理持久化集合时，依赖equals和hashCode方法识别同一业务实体，你未重写这两个方法，默认按对象内存地址判断相等，会导致两类异常：
- 未持久化的Transaction实体id为null，多个新实体compareTo返回0，TreeSet会误判为同一元素仅保留第一条
- 持久化上下文加载的代理对象、不同会话加载的同id实体，会因内存地址不同导致TreeSet排序逻辑混乱，出现随机顺序
@SortNatural是内存排序逻辑，若你自定义查询时使用了fetch join未指定排序、开启了集合分页或二级缓存脏数据，也会打乱排序结果

修复步骤

重写Transaction类的equals和hashCode方法，逻辑与compareTo保持一致：

@Override
public boolean equals(Object o) {
    if (this == o) return true;
    if (o == null || getClass() != o.getClass()) return false;
    Transaction that = (Transaction) o;
    return id != null && id.equals(that.id);
}

@Override
public int hashCode() {
    // 固定hashCode避免实体持久化前后id变更导致的哈希值变化
    return getClass().hashCode();
}

可额外添加JPA标准@OrderBy注解，在数据库查询阶段就完成排序，降低内存排序开销：

@OneToMany(cascade = CascadeType.PERSIST, mappedBy = "category")
@SortNatural
@OrderBy("id ASC")
private SortedSet<Transaction> transactions = new TreeSet<>();