Spring Boot使用JpaRepository查询时出现无限递归JSON过大问题求助

兄弟，我太懂你这种返回的JSON大到离谱的痛苦了！十有八九是实体映射里的循环引用或者不必要的关联数据加载搞的鬼，给你几个实用的解决办法：

1. 干掉循环引用（最常见的原因） #

如果你的Customer实体和其他实体（比如Order、Address）是双向关联的，Jackson序列化的时候会无限递归——把关联的对象再关联回去，最后生成的JSON就像俄罗斯套娃一样无限膨胀。

解决办法有两种：

• 用@JsonIgnore直接忽略其中一端的关联字段：

  @Entity
  @Table(name = "customers")
  public class Customer {
      // 其他字段...
      // 假设关联了Order列表，加@JsonIgnore忽略这个字段的序列化
      @JsonIgnore
      @OneToMany(mappedBy = "customer")
      private List<Order> orders;
  }
  

• 用@JsonManagedReference和@JsonBackReference区分双向关联的主动/被动端：

  // Customer实体（主动端）
  @Entity
  public class Customer {
      // 其他字段...
      @JsonManagedReference
      @OneToMany(mappedBy = "customer")
      private List<Order> orders;
  }
  
  // Order实体（被动端）
  @Entity
  public class Order {
      // 其他字段...
      @JsonBackReference
      @ManyToOne
      @JoinColumn(name = "customer_id")
      private Customer customer;
  }
  

2. 把EAGER加载改成LAZY加载 #

如果你的关联字段用了FetchType.EAGER（默认ManyToOne是EAGER），JPA会自动把关联的实体一起查出来——不管你用不用得到，直接塞进JSON里导致体积暴涨。改成懒加载，只在需要的时候才加载关联数据：

@Entity
public class Customer {
    // 把EAGER改成LAZY
    @ManyToOne(fetch = FetchType.LAZY)
    @JoinColumn(name = "address_id")
    private Address address;
}

⚠️ 注意：懒加载在Controller层直接访问关联字段会报错（因为EntityManager已经关闭），所以最好配合下面的DTO方案一起用，或者用OpenEntityManagerInViewFilter（但不推荐，可能有性能隐患）。

3. 用DTO精准控制返回内容 #

最稳妥的办法就是不要直接返回实体类，而是创建一个只包含前端需要字段的DTO（数据传输对象），把实体的属性复制到DTO里再返回。这样不仅能解决JSON过大的问题，还能避免暴露不必要的实体字段：

// 创建CustomerDTO，只保留需要返回的字段
public class CustomerDTO {
    private Long id;
    private String name;
    private String email;

    // 构造器、getter/setter，也可以用MapStruct这类工具自动转换
    public CustomerDTO(Customer customer) {
        this.id = customer.getId();
        this.name = customer.getName();
        this.email = customer.getEmail();
    }
}

// Service层负责转换
@Service
public class CustomerService {
    @Autowired
    private CustomerRepository customerRepo;

    public CustomerDTO getCustomerById(Long id) {
        Customer customer = customerRepo.findById(id).orElseThrow();
        return new CustomerDTO(customer);
    }
}

// Controller返回DTO
@RestController
@RequestMapping("/customers")
public class CustomerController {
    @Autowired
    private CustomerService customerService;

    @GetMapping("/{id}")
    public ResponseEntity<CustomerDTO> getCustomer(@PathVariable Long id) {
        return ResponseEntity.ok(customerService.getCustomerById(id));
    }
}

4. 用Jackson视图按需返回字段 #

如果不想写DTO，可以用Jackson的@JsonView来定义不同的视图，指定哪些字段需要序列化：

// 定义视图接口
public interface CustomerBasicView {}

// 实体类标注字段所属的视图
@Entity
public class Customer {
    @JsonView(CustomerBasicView.class)
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    @JsonView(CustomerBasicView.class)
    private String name;

    // 这个敏感字段不会在BasicView里返回
    private String password;

    @JsonView(CustomerBasicView.class)
    private String email;
}

// Controller指定用BasicView返回
@RestController
@RequestMapping("/customers")
public class CustomerController {
    @Autowired
    private CustomerRepository customerRepo;

    @GetMapping("/{id}")
    @JsonView(CustomerBasicView.class)
    public ResponseEntity<Customer> getCustomer(@PathVariable Long id) {
        return ResponseEntity.ok(customerRepo.findById(id).orElseThrow());
    }
}

你可以先检查下你的Customer实体有没有双向关联或者EAGER加载的字段，先试试第一种或者第二种办法；要是想长期规范代码，DTO方案是最推荐的做法。

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