SpringBoot接口执行成功但返回空记录问题咨询

核心原因 #

该问题本质是Java对象转JSON序列化失败：调试时看到的List<EhcStatus>里的对象本身有完整数据，但Spring MVC默认使用的Jackson序列化工具无法读取到EhcStatus类的属性值，最终将每个对象序列化为空对象{}，所以接口返回[{}]。

常见触发场景 #

• EhcStatus实体类的私有属性没有提供符合JavaBean规范的public getter方法，Jackson默认无法读取无getter的私有属性
• EhcStatus类上或属性上加了错误的JSON过滤注解，比如@JsonIgnore、@JsonIgnoreProperties("*")，导致所有属性被排除在序列化范围外
• 实体类如果是JPA/MyBatis查询返回的持久化对象，配置了属性懒加载，返回接口时事务已关闭，序列化时无法读取懒加载的属性值
• EhcStatus是非静态内部类，Jackson无法正确序列化非静态内部类的属性
• 项目配置了全局Jackson序列化规则，错误过滤了所有字段

排查解决步骤 #

• 先确认是序列化问题：在return代码前手动调用Jackson序列化打印结果，验证是否直接输出[{}]：

// 引入com.fasterxml.jackson.databind.ObjectMapper
System.out.println(new ObjectMapper().writeValueAsString(EhcStatsRecord));

如果打印结果确实是空对象数组，即可完全排除接口逻辑、响应包装类的问题，聚焦序列化修复即可。

• 检查EhcStatus类的getter方法：所有需要返回的属性都要有public类型的getter，命名严格遵循「get+首字母大写的属性名」规则，boolean类型属性的getter可使用is开头。如果用Lombok，直接给类加@Data注解自动生成标准getter/setter。
• 排查EhcStatus类的JSON注解：移除属性上误加的@JsonIgnore注解，检查类上的@JsonIgnoreProperties有没有把需要返回的字段加入排除列表。
• 持久化对象懒加载问题：如果是JPA实体类懒加载导致的，可以给需要序列化的懒加载属性加@JsonProperty注解强制序列化，或把对应属性的FetchType改为EAGER立即加载。
• 检查全局Jackson配置：查看application.yml/application.properties中的Jackson配置，有没有自定义字段过滤、序列化规则导致属性被忽略。

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