Spring Data JPA配置OneToMany关联报外键约束失败如何解决

你出现的外键错误完全是@JoinColumn的配置逻辑搞反导致的：

• 单向@OneToMany关联中，@JoinColumn的name属性指的是多端（Vehicle对应表）中用来存储一端（User对应表）主键的外键字段名，你填写的vehicleId刚好是Vehicle实体自身的主键字段名，Hibernate会误认为Vehicle表的主键vehicleId是引用User表userId的外键。
• 这就导致插入Vehicle数据时，你填的vehicleId值没有对应的User记录，触发外键约束失败；同时启动时的DDL语句因为字段冲突也无法删除旧的约束，抛出第一个错误。

方案1：保留单向@OneToMany关联 #

直接修改User类的关联注解，把外键字段名改成和Vehicle现有字段不冲突的名称即可，示例代码：

@Entity
@Data
@Table(name = "UserDetails")
public class User {
    @Id
    private int userId;
    
    private String userName;
    
    // 外键字段设为user_id，显式指定引用User的userId字段避免歧义
    @OneToMany
    @JoinColumn(name = "user_id", referencedColumnName = "userId")
    private Collection<Vehicle> vehicles = new ArrayList<>();
}

修改完成后把配置文件中spring.jpa.hibernate.ddl-auto参数设为create（开发环境适用），启动时会自动重建所有表，彻底清除错误的约束配置。

方案2：改用更规范的双向关联（推荐） #

双向关联的维护逻辑更清晰，不会出现外键配置搞反的问题：

1. 先在Vehicle类新增多对一关联字段：

@Data
@Entity
@NoArgsConstructor(force = true)
@RequiredArgsConstructor
public class Vehicle {
    @Id
    private final int vehicleId;
    
    private final String vehicleName;

    // 新增多对一关联，指向所属User
    @ManyToOne
    @JoinColumn(name = "user_id")
    private User user;
}

2. 再修改User类的一对多注解，用mappedBy指定关联由Vehicle端维护：

@OneToMany(mappedBy = "user")
private Collection<Vehicle> vehicles = new ArrayList<>();

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