Spring REST Controller返回空JSON（Iterable数据结构）原因排查

这种情况我之前排查过好多次——明明Iterable里有数据，REST接口却返回空JSON，大概率是序列化环节掉链子了，咱们一步步拆解可能的原因：

1. 实体类（Entity）字段未开放序列化权限 #

• 最常见的坑：Entity的字段是private，但没给公共getter方法。Jackson默认通过getter来读取字段值，没有的话它就拿不到数据，自然返回空JSON。
• 解决办法：
  • 给需要返回的字段添加public级别的getter；
  • 或者用@JsonProperty注解标注private字段，强制Jackson序列化该字段；
  • 不推荐直接把字段改成public，会破坏类的封装性。

2. Resource类包装出错 #

• 如果你用了Spring HATEOAS的Resource/Resources来包装Iterable数据，要注意是否正确封装了实体对象。比如不小心创建了空的Resource实例，或者没有正确关联到实体数据，都会导致返回空结构。
• 解决办法：
  • 确保包装逻辑正确，比如new Resources<>(entityList)，而不是new Resources<>()；
  • 检查Spring HATEOAS依赖版本和Spring Boot是否兼容，版本不匹配也可能导致序列化异常。

3. 延迟加载导致的序列化失败 #

• 如果你返回的是JPA原生的Iterable实现（比如Hibernate的查询结果），这类对象可能是延迟加载的。当Controller返回数据时，数据库会话已经关闭，Jackson去遍历的时候拿不到实际数据，就会返回空数组。
• 解决办法：
  • 在事务范围内把Iterable转换成普通List，比如return new ArrayList<>(iterable);，让数据提前加载到内存；
  • 调整实体类的关联字段配置，关闭不必要的延迟加载（根据业务场景判断）；
  • 或者开启Open Session in View（不推荐，可能引发性能问题）。

4. 序列化规则被错误配置 #

• 检查实体类或全局Jackson配置里有没有@JsonIgnore、@JsonIgnoreProperties这类注解，会不会不小心把所有字段都排除了。比如Entity类上标了@JsonIgnoreProperties({"*"})，那所有字段都会被忽略，返回空JSON。
• 解决办法：
  • 逐个检查实体类的注解，移除不合理的忽略规则；
  • 全局配置里如果有过滤规则，确认是否误操作排除了目标实体的所有字段。

5. 实体类缺少无参构造函数 #

• Jackson默认要求实体类有无参构造函数，如果你的Entity只有带参构造函数，Jackson无法实例化对象进行序列化，有时候框架会静默处理，返回空结构（而非直接报错）。
• 解决办法：
  • 给Entity添加无参构造函数；
  • 或者用@JsonCreator注解标注带参构造函数，明确告诉Jackson如何实例化对象。

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