JPA嵌套对象LAZY FETCH仅返回首个对象问题排查

先梳理你的代码存在的关键问题，对应解决方法如下：

一、核心问题点分析 #

• Collab类未标记为JPA实体：Collab类缺少@Entity和@Table注解，JPA无法将其识别为持久化实体，即便数据库中有数据，关联查询时也无法正确映射关联关系。
• 外键列名不匹配：Account实体的主键accountId在数据库中默认会映射为account_id（驼峰转下划线规则），但Collab类中@JoinColumn(name = "accountId")指定的列名与实际数据库列名不符，导致关联查询无法正确匹配，只能查到部分数据。
• HashSet依赖的equals/hashCode逻辑问题：Collab类仅用collabId作为equals/hashCode的判断依据，如果对象在未生成主键（持久化前）就被加入集合，多个不同实例会被判定为相等，HashSet自动去重后仅保留一个元素。
• Account类的EqualsAndHashCode包含关联集合：Account类的@EqualsAndHashCode默认包含所有字段，包括collaborators集合，这会引发循环引用问题，同时干扰集合的正确加载。
• 软删除逻辑未统一：Account使用了软删除过滤，但Collab未继承Base类的软删除字段，也未添加对应的过滤注解，若数据库中存在被标记为删除的Collab记录，会导致部分数据被过滤或关联逻辑异常。

二、修正后的代码示例 #

1. Base类（保持不变，确保子类继承） #

@Data
@Getter
@Setter
@Accessors(fluent = false, chain = true)
@NoArgsConstructor
@AllArgsConstructor
@EqualsAndHashCode(onlyExplicitlyIncluded = true)
@MappedSuperclass
@Slf4j
class Base {
  private Timestamp createdTime;
  private Timestamp modifiedTime;
  private String createdBy;
  private String modifiedBy;
  private Boolean deleted = false;
}

2. 修正Account实体类 #

@Getter
@Setter
@Builder
@EqualsAndHashCode(onlyExplicitlyIncluded = true) // 仅包含主键字段，避免循环引用
@NoArgsConstructor
@AllArgsConstructor
@Entity
@Table(name = "account")
@SQLDelete(sql = "UPDATE account SET deleted = true WHERE account_id = ?")
@Where(clause = "deleted=false")
class Account extends Base { // 继承Base获取软删除等公共字段
  @Id
  @EqualsAndHashCode.Include()
  @GeneratedValue(strategy = GenerationType.IDENTITY)
  private Long accountId;

  @Builder.Default
  @OneToMany(fetch = FetchType.LAZY, mappedBy = "account", cascade = {CascadeType.ALL})
  private Set<Collab> collaborators = new HashSet<>(0);
  private String objId;
}

3. 修正Collab实体类 #

@Getter
@Setter
@Builder
@EqualsAndHashCode(onlyExplicitlyIncluded = true)
@NoArgsConstructor
@AllArgsConstructor
@Entity
@Table(name = "collab") // 指定数据库表名
@Where(clause = "deleted=false") // 统一软删除过滤逻辑
class Collab extends Base { // 继承Base类
  @Id
  @EqualsAndHashCode.Include()
  @GeneratedValue(strategy = GenerationType.IDENTITY)
  private Long collabId;
  private String email;
  private String role;
  @JsonBackReference
  @JoinColumn(name = "account_id") // 修正外键列名，匹配数据库实际列名
  @ManyToOne(fetch = FetchType.EAGER)
  private Account account;
}

4. 修正Repository接口 #

// 必须继承JpaRepository才能获得完整的JPA查询支持
public interface AccountRepo extends JpaRepository<Account, Long> {
  Optional<Account> findByObjId(String objId);
}

三、额外验证步骤 #

1. 检查数据库中Collab表的外键列是否为account_id，若实际列名不同，调整@JoinColumn的name属性匹配。
2. 若使用Builder模式创建Account对象，确保添加Collab元素时，每个Collab实例的account属性都正确指向当前Account对象，避免关联关系断裂。
3. 测试查询时，确保处于事务上下文内（比如在Service层添加@Transactional），避免懒加载集合的加载异常。

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