Spring Boot JPA配置ManyToOne关联触发Hibernate映射错误如何解决

问题根因 #

• 你的JPA实体配置混用了字段访问策略和属性（getter）访问策略，导致Hibernate无法识别orders字段的@OneToMany注解，将其当作普通字段尝试映射到数据库，而数据库没有对应java.util.List的原生类型，因此抛出该异常。
• 你的Person类中，主键id的@Id、@GeneratedValue注解标注在getId() getter方法上，JPA会默认全局使用属性访问策略，所有映射注解都需要标注在getter方法上才会生效；但你把@OneToMany注解标注在了orders字段上，该注解不会被Hibernate识别。

修复方案 #

方案1：统一使用属性访问策略 #

将@OneToMany注解移到orders字段的getter方法上，同时配置mappedBy指定关联关系由Order类的person字段维护，避免生成多余的中间关联表：

@Entity
public class Person {
    private Long id;
    private List<Order> orders;

    public void setId(Long id) {
        this.id = id;
    }

    @Id
    @GeneratedValue
    public Long getId() {
        return id;
    }

    // 把注解移到此处，新增mappedBy配置
    @OneToMany(mappedBy = "person", cascade = CascadeType.ALL, targetEntity = Order.class)
    public List<Order> getOrders() {
        return orders;
    }

    public void setOrders(List<Order> orders) {
        this.orders = orders;
    }
}

方案2：统一使用字段访问策略 #

将@Id、@GeneratedValue注解移到id字段上，所有注解都标注在字段上即可：

@Entity
public class Person {
    // 把主键注解移到字段上
    @Id
    @GeneratedValue
    private Long id;

    @OneToMany(mappedBy = "person", cascade = CascadeType.ALL, targetEntity = Order.class)
    private List<Order> orders;

    public void setId(Long id) {
        this.id = id;
    }

    public Long getId() {
        return id;
    }

    public List<Order> getOrders() {
        return orders;
    }

    public void setOrders(List<Order> orders) {
        this.orders = orders;
    }
}

额外优化建议 #

• Order实体类名和SQL关键字ORDER冲突，建议修改为BizOrder、UserOrder等自定义名称，避免后续执行SQL时出现语法错误。
• 双向关联场景下@ManyToOne侧不要配置CascadeType.ALL，否则删除Order会级联删除关联的Person，建议将cascade配置移到@OneToMany侧即可。

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