JPA EntityManagerFactory初始化失败：实体关联配置错误排查

错误原因 #

1. 实体类命名不规范：courses类名不符合Java大驼峰命名规范，应改为Course，JPA对类名和属性名的大小写敏感。
2. 关联属性名不匹配：Course类中@OneToOne(mappedBy = "courses")指定的属性名错误，User类中的关联属性是course（单数），而非courses。
3. 外键列冲突：User类中@JoinColumn(name = "id")将外键列设置为自身主键id，导致字段重复，违反数据库约束。
4. 主键映射逻辑错误：Course类使用IDENTITY策略生成主键，不符合一对一关联的主键映射逻辑，应关联User的主键作为自身主键。

修正后的实体类代码 #

User 实体类

package example.registrationlogindemo.entity;

import jakarta.persistence.*;
import lombok.AllArgsConstructor;
import lombok.Getter;
import lombok.NoArgsConstructor;
import lombok.Setter;
import java.util.ArrayList;
import java.util.List;

@Getter
@Setter
@NoArgsConstructor
@AllArgsConstructor
@Entity
@Table(name="users")
public class User {
    private static final long serialVersionUID = 1L;

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    // 维护端：外键列在users表，指向courses表的user_id
    @OneToOne(cascade = CascadeType.ALL)
    @JoinColumn(name = "course_user_id", referencedColumnName = "user_id")
    private Course course;

    @Column(nullable=false)
    private String name;

    @Column(nullable=false, unique=true)
    private String email;

    @Column(nullable=false)
    private String password;

    @ManyToMany(fetch = FetchType.EAGER, cascade=CascadeType.ALL)
    @JoinTable(
            name="users_roles",
            joinColumns={@JoinColumn(name="USER_ID", referencedColumnName="ID")},
            inverseJoinColumns={@JoinColumn(name="ROLE_ID", referencedColumnName="ID")})
    private List<Role> roles = new ArrayList<>();
}

Course 实体类

package example.registrationlogindemo.entity;

import jakarta.persistence.*;

@Entity
@Table(name = "courses")
public class Course {

    @Id
    @Column(name = "user_id")
    private Long userId;

    // 被维护端：关联User类的course属性，使用User的主键作为自身主键
    @OneToOne(mappedBy = "course")
    @MapsId
    private User user;

    @Column(nullable=false)
    private Long java;

    public Long getUserId() {
        return userId;
    }

    public void setUserId(Long userId) {
        this.userId = userId;
    }

    public User getUser() {
        return user;
    }

    public void setUser(User user) {
        this.user = user;
    }

    public Long getJava() {
        return java;
    }

    public void setJava(Long java) {
        this.java = java;
    }
}

说明 #

• User作为关联维护端，通过@JoinColumn指定外键列course_user_id，指向courses表的user_id主键。
• Course作为被维护端，通过@OneToOne(mappedBy = "course")关联User的属性，并使用@MapsId复用User的主键作为自身主键，实现一对一绑定。
• 移除了User类中冗余的手动getter/setter，依赖Lombok注解自动生成。

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