Spring REST结合Jackson与Lombok返回字段默认值为null问题

嘿，我之前也踩过类似的坑，咱们一步步来排查解决这个问题！

你遇到的情况是：用Lombok的@Data注解生成Getter/Setter，但REST接口返回的实体字段全是null。核心原因大概率是Jackson无法正确获取实体字段的值，要么是Lombok没生成对应的Getter方法，要么是序列化配置出了冲突，也可能是JPA映射的问题。

1. 先确认Lombok是否真的生效了 #

这是最常见的坑！很多人只加了依赖，忘了给IDE装Lombok插件，导致编译时根本没生成Getter/Setter。

• 检查依赖：确保Maven/Gradle里的Lombok依赖正确（以Maven为例）：

<dependency>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
    <optional>true</optional>
</dependency>

• IDE插件与配置：
  • IntelliJ：去插件市场搜索安装「Lombok」，然后开启注解处理（Settings -> Build, Execution, Deployment -> Compiler -> Annotation Processors，勾选Enable annotation processing）。
  • Eclipse：同样安装Lombok插件，并且确保启用了注解处理。
• 验证生成结果：编译项目后，去target/classes目录下找到Projet.class，反编译看看有没有getCodeProjet()这类Getter方法——如果没有，说明Lombok没生效，先解决这个问题！

2. 移除冲突的@JsonAutoDetect注解 #

你加了@JsonAutoDetect(fieldVisibility = Visibility.ANY)，但@Data已经生成了public的Getter方法，Jackson默认会通过Getter来序列化对象。这个注解会让Jackson直接访问私有字段，反而可能和JPA代理对象（比如Hibernate生成的代理）产生冲突，导致拿不到真实值。

修改后的实体类可以简化成这样：

@Data
@Entity
public class Projet implements Serializable {
    private static final long serialVersionUID = -7268509549664338191L;

    @Id
    @GeneratedValue(strategy=GenerationType.IDENTITY)
    private Long codeProjet;
    
    // 其他字段示例
    private String nomProjet;
    private LocalDate dateDebut;
}

3. 检查JPA映射与数据查询逻辑 #

• 字段映射：如果实体字段名和数据库列名不一致（比如实体是codeProjet，数据库是code_projet），虽然Spring Boot默认开启驼峰转下划线，但可以显式加@Column注解确保映射正确：

@Column(name = "code_projet")
private Long codeProjet;

• 查询结果验证：在Controller/Service层打印查询到的Projet对象，确认从数据库查出来的实体本身字段就有值，而不是查询逻辑返回了空对象。比如：

@GetMapping("/projets/{id}")
public ResponseEntity<Projet> getProjet(@PathVariable Long id) {
    Projet projet = projetRepository.findById(id).orElse(null);
    System.out.println(projet); // 打印看字段是否有值
    return ResponseEntity.ok(projet);
}

4. 特殊情况：JPA懒加载代理问题 #

如果实体里有懒加载的关联字段（比如@ManyToOne(fetch = FetchType.LAZY)），返回时可能因为代理对象未初始化导致字段为null。这时候可以：

• 用@JsonIgnoreProperties({"hibernateLazyInitializer", "handler"})注解实体类，忽略Hibernate代理的额外属性；
• 或者在查询时用fetch join主动加载关联数据。

优先排查Lombok是否生效，这是最容易忽略的点；然后去掉可能冲突的Jackson注解，再验证数据库查询结果是否正确，基本就能解决问题啦！

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