Hibernate中@OneToMany报错‘Can't find inverse attribute’求助

学习Spring课程时，使用Hibernate的@OneToOne与@OneToMany注解时遇到报错：Can't find inverse attribute。课程中相同代码可正常运行，但本地环境报错。已知XML映射文件可通过inverse属性处理，但本地未使用XML映射，以下是代码及排查解决建议：

相关代码 #

Instructor.java #

@Entity
@Table(name = "instructor")
@Getter
@Setter
@NoArgsConstructor
public class Instructor {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    @Column(name = "id")
    private int id;

    @Column(name = "first_name")
    private String firstName;

    @Column(name = "last_name")
    private String lastName;

    @Column(name = "email")
    private String email;

    @OneToOne(cascade = CascadeType.ALL)
    @JoinColumn(name = "instructor_detail_id")
    private InstructorDetail instructorDetail;

    @OneToMany(mappedBy = "instructor")
    private List<Course> courses;

    public Instructor(String firstName, String lastName, String email) {
        this.firstName = firstName;
        this.lastName = lastName;
        this.email = email;
    }

    @Override
    public String toString() {
        return "Instructor{" +
                "id=" + id +
                ", firstName='" + firstName + '\'' +
                ", lastName='" + lastName + '\'' +
                ", email='" + email + '\'' +
                ", instructorDetail=" + instructorDetail +
                '}';
    }
}

Course.java #

@Entity
@Table(name = "course")
@Getter
@Setter
@NoArgsConstructor
public class Course {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    @Column(name = "id")
    private int id;

    @Column(name = "title")
    private String title;

    @ManyToOne(cascade = {CascadeType.DETACH, CascadeType.MERGE, CascadeType.PERSIST, CascadeType.REFRESH})
    @JoinColumn(name = "instructor_id")
    private Instructor instructor;

    public Course(String title) {
        this.title = title;
    }

    @Override
    public String toString() {
        return "Course{" +
                "id=" + id +
                ", title='" + title + '\'' +
                ", instructor=" + instructor +
                '}';
    }
}

hibernate.cfg.xml #

<!DOCTYPE hibernate-configuration PUBLIC
        "-//Hibernate/Hibernate Configuration DTD 3.0//EN"
        "http://www.hibernate.org/dtd/hibernate-configuration-3.0.dtd">

<hibernate-configuration>

    <session-factory>

        <!-- JDBC Database connection settings -->
        <property name="connection.driver_class">com.mysql.cj.jdbc.Driver</property>
        <property name="connection.url">jdbc:mysql://localhost:3306/hb-03-one-to-many?useSSL=false&amp;serverTimezone=UTC</property>
        <property name="connection.username"></property>
        <property name="connection.password"></property>

        <!-- JDBC connection pool settings ... using built-in test pool -->
        <property name="connection.pool_size">1</property>

        <!-- Select our SQL dialect -->
        <property name="dialect">org.hibernate.dialect.MySQLDialect</property>

        <!-- Echo the SQL to stdout -->
        <property name="show_sql">false</property>

        <!-- Set the current session context -->
        <property name="current_session_context_class">thread</property>
 
    </session-factory>

</hibernate-configuration>

排查及解决步骤 #

1. 补全实体类映射配置
   检查hibernate.cfg.xml是否添加了所有实体类的映射声明，缺失会导致Hibernate无法识别双向关联的实体。需在<session-factory>内添加：

   <mapping class="你的包路径.Instructor"/>
   <mapping class="你的包路径.Course"/>
   <mapping class="你的包路径.InstructorDetail"/>
   

2. 核对Hibernate版本一致性
   课程使用的Hibernate版本可能与本地不同，部分旧版本对mappedBy属性的解析逻辑有差异。确保本地依赖的Hibernate版本与课程完全一致。

3. 检查双向关联属性名称
   确认Instructor类中@OneToMany(mappedBy = "instructor")的属性名，与Course类中private Instructor instructor;的变量名完全一致（大小写敏感），拼写错误会导致无法找到反向属性。

4. 排除循环引用干扰
   Instructor和Course的toString方法中包含了关联对象，可能引发序列化循环引用问题，间接导致Hibernate解析异常。可暂时注释掉toString中的关联对象部分，重新运行测试。

5. 清理编译缓存
   IDE的编译缓存可能导致旧代码残留，执行清理项目缓存并重新编译的操作（如IDEA中Build -> Clean Project），再重新运行程序。

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