SpringBoot+JPA开发遇InvalidDefinitionException：找不到id_ristorante属性如何解决？

场景复现 #

使用SpringBoot + JPA + PostgreSQL开发后端，Ristorante实体类以id_ristorante为主键，代码如下：

@Entity
@Table(name = "ristorante")
@JsonIdentityInfo(generator = ObjectIdGenerators.PropertyGenerator.class, property = "id_ristorante")
public class Ristorante implements Serializable{

    //Primary key
    @Id
    @Column(name = "id_ristorante")
    private Integer id_ristorante;

    //Constructors
    public Ristorante() {
    }
}

尝试从数据库获取数据时，Spring抛出以下错误：

2023-02-13T18:58:01.735+01:00  WARN 6304 --- [nio-8080-exec-1] .c.j.MappingJackson2HttpMessageConverter : Failed to evaluate Jackson serialization for type [class com.ingsw.server.ratatouille23.Models.Entities.Ristorante]: com.fasterxml.jackson.databind.exc.InvalidDefinitionException: Invalid Object Id definition for com.ingsw.server.ratatouille23.Models.Entities.Ristorante: cannot find property with name 'id_ristorante' 
2023-02-13T18:58:01.742+01:00  WARN 6304 --- [nio-8080-exec-1] .w.s.m.s.DefaultHandlerExceptionResolver : Resolved [org.springframework.web.HttpMediaTypeNotAcceptableException: No acceptable representation]

其他实体类无此问题，在@Column下添加@JsonManagedReference可解决，但不清楚原因。

原因分析 #

报错核心是Jackson在序列化Ristorante时，找不到@JsonIdentityInfo指定的id_ristorante属性：

1. id_ristorante是私有字段，Jackson默认仅能访问公共的getter方法，你的实体未给该字段添加getter，导致Jackson无法识别该属性。
2. 添加@JsonManagedReference能解决是因为该注解会强制Jackson特殊处理目标字段，绕过默认访问权限检查，间接让Jackson读取到私有主键，但这属于误用注解，不是针对问题的正确解法。

解决方案 #

方案1：给主键字段添加getter方法（推荐） #

给id_ristorante添加公共getter方法，让Jackson正常访问该属性：

@Entity
@Table(name = "ristorante")
@JsonIdentityInfo(generator = ObjectIdGenerators.PropertyGenerator.class, property = "id_ristorante")
public class Ristorante implements Serializable{

    @Id
    @Column(name = "id_ristorante")
    private Integer id_ristorante;

    public Ristorante() {
    }

    // 添加getter方法
    public Integer getId_ristorante() {
        return id_ristorante;
    }
}

方案2：添加@JsonProperty注解 #

在私有主键字段上添加@JsonProperty注解，强制Jackson识别该属性：

@Id
@Column(name = "id_ristorante")
@JsonProperty("id_ristorante")
private Integer id_ristorante;

方案3：修改字段访问修饰符（不推荐） #

直接将id_ristorante的访问修饰符改为public，Jackson可直接读取，但会破坏类的封装性：

@Id
@Column(name = "id_ristorante")
public Integer id_ristorante;

关于@JsonManagedReference的生效原因 #

@JsonManagedReference原本用于解决双向关联的序列化循环引用，标记父级关联字段让Jackson优先序列化。当你把它加在主键字段上时，Jackson会绕过默认的访问权限检查读取私有字段，因此报错消失，但这并非该注解的设计用途，后续若实体添加真正的关联关系，可能引发其他序列化问题，不建议用此方式解决当前问题。

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