Spring Boot 如何忽略同类型嵌套实体中的深层关联属性

方案1：使用Jackson注解直接控制序列化（最简实现） #

直接在实体类的supervisor属性上添加@JsonIgnoreProperties注解，指定忽略嵌套对象内的supervisor字段即可，代码修改如下：

@Entity
public class Employee {
      private String name;
      @OneToOne
      @JoinColumn(name = "supervisor_id", referencedColumnName = "id")
      // 序列化时忽略当前属性值内部的supervisor字段
      @JsonIgnoreProperties(value = "supervisor", allowSetters = true)
      private Employee supervisor;
      //getters and setters
}

该方案无需额外编写代码，序列化后会自动去掉上级对象中的supervisor字段，完全符合你期望的JSON结构。

方案2：使用DTO层做字段隔离（业务场景推荐） #

如果不想污染实体类的通用逻辑，可以新增DTO类做返回字段的显式控制，和实体层解耦：

// 员工返回DTO
public class EmployeeDTO {
    private String name;
    // 上级字段用仅包含name的专用DTO接收
    private SupervisorDTO supervisor;
    // 省略getter、setter
}

// 上级专用DTO，仅保留需要返回的字段
public class SupervisorDTO {
    private String name;
    // 省略getter、setter
}

查询到Employee实体后，用MapStruct、ModelMapper等工具手动/自动转换为DTO返回即可，该方式灵活度最高，适合多业务场景下不同返回字段的需求。

方案3：使用Jackson @JsonView做多视图适配 #

如果需要同一实体类在不同接口返回不同的字段，可以用JsonView做视图分组：

// 定义视图分组
public class EmployeeView {
    // 基础字段视图
    public interface Base {}
    // 带直属上级的视图，继承基础字段
    public interface WithSupervisor extends Base {}
}

// 实体类添加视图注解
@Entity
public class Employee {
      @JsonView(EmployeeView.Base.class)
      private String name;
      @OneToOne
      @JoinColumn(name = "supervisor_id", referencedColumnName = "id")
      @JsonView(EmployeeView.WithSupervisor.class)
      private Employee supervisor;
      //getters and setters
}

在SpringBoot接口中指定返回视图即可：

@GetMapping("/employee/{id}")
@JsonView(EmployeeView.WithSupervisor.class)
public Employee getEmployee(@PathVariable Long id) {
    return employeeRepository.findById(id).orElseThrow();
}

序列化时只会返回对应视图标记的字段，上级对象的supervisor字段没有WithSupervisor视图标记，会自动过滤不返回。

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