使用EntityManager返回List却得到嵌套列表，原因是什么？

1. 排查查询语句返回结构 #

如果你的JPQL/原生SQL语句返回了多个对象的组合（比如select q, ql from Quota q join q.quotaLines ql），EntityManager会返回List<Object[]>，每个数组包含Quota和QuotaLine实例，最终就会出现数组套数组的嵌套结构。

修复方案：

• 若要返回完整Quota实体（含关联的QuotaLine），JPQL使用fetch join加载关联集合，同时确保只查询实体本身：

  // 用distinct避免join导致的重复Quota对象
  List<Quota> quotas = entityManager.createQuery(
      "select distinct q from Quota q left join fetch q.quotaLines", 
      Quota.class
  ).getResultList();
  

• 若使用原生SQL，必须指定映射的实体类：

  String sql = "SELECT q.* FROM quota q LEFT JOIN quota_line ql ON q.id = ql.quota_id";
  List<Quota> quotas = entityManager.createNativeQuery(sql, Quota.class).getResultList();
  

2. 检查EntityManager调用方式 #

误用查询方法也会导致嵌套结构：

• 原生SQL未指定实体类时，默认返回List<Object[]>，每个数组对应一行的字段值；
• 错误使用getSingleResult()后强行转成List，会导致单个对象被包装成数组再放入列表。

修复方案：

• 确保JPQL查询明确指定返回实体类型（createQuery的第二个参数）；
• 原生查询必须绑定实体类，或通过@SqlResultSetMapping自定义结果映射。

3. 修正实体关联映射 #

Quota与QuotaLine的关联配置错误，可能导致序列化时出现异常嵌套：

• 检查@OneToMany的mappedBy属性是否与QuotaLine中@ManyToOne的属性名一致；
• 未处理循环引用会让JSON序列化工具（如Jackson）生成异常结构。

修复方案：

• 修正关联注解：

  // Quota类
  @OneToMany(mappedBy = "quota", fetch = FetchType.LAZY)
  @JsonManagedReference // 解决循环引用
  private List<QuotaLine> quotaLines;
  
  // QuotaLine类
  @ManyToOne
  @JsonBackReference // 解决循环引用
  private Quota quota;
  

• 给所有实体类添加无参构造器，确保序列化正常。

4. 验证序列化逻辑 #

如果查询返回的确实是List<Quota>，但Postman显示嵌套数组，大概率是序列化工具的问题：

• 检查是否开启了Hibernate代理对象的序列化（比如懒加载的集合被序列化为代理数组）；
• 禁用代理对象序列化，或确保查询时用fetch join加载所有需要的关联数据。

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