JPA/Hibernate中ManyToOne关联属性belongsTo始终为null问题

我有两个互相引用的实体BookingLegEntity和BookingEntity，但通过findByUuid查询BookingLegEntity时，其belongsTo字段始终为null。数据库中的关联数据是正确的，且之前代码正常工作，现在突然失效。

实体代码如下：

BookingLegEntity #

@Entity
@Table(name = "BOOKING_LEG")
@SQLDelete(sql = "UPDATE BOOKING_LEG SET deleted = true WHERE id=?")
@Where(clause = "deleted=false")
public class BookingLegEntity {

    @Id
    @Column(name = "ID", unique = true, updatable = false)
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private long id;

    @Column(name = "UUID", nullable = false)
    private UUID uuid;

    @ManyToOne(cascade = CascadeType.ALL, fetch = FetchType.EAGER)
    @JoinColumn(name = "BELONGS_TO")
    private BookingEntity belongsTo;

    // 其他字段省略
}

BookingEntity #

@Entity
@Table(name="BOOKINGS")
@SQLDelete(sql = "UPDATE BOOKINGS SET deleted = true WHERE id=?")
@Where(clause = "deleted=false")
public class BookingEntity {

    @Id
    @Column(name="ID", unique=true, updatable = false)
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private long id;

    // 其他字段省略

    @OneToMany(mappedBy = "belongsTo", cascade = CascadeType.ALL, fetch = FetchType.EAGER)
    private Set<BookingLegEntity> bookingLegs = new HashSet<>();

    // 其他字段省略
}

仓库代码：

@Repository
public interface BookingLegRepository extends JpaRepository<BookingLegEntity, Long> {
    Optional<BookingLegEntity> findByUuid(UUID id);
}

排查方向： #

• 软删除过滤导致关联实体不可见：两个实体都配置了@Where(clause = "deleted=false")，如果对应的BookingEntity被软删除（deleted字段为true），JPA会过滤掉该实体，导致belongsTo为null。直接查询数据库中BOOKINGS表对应ID的记录，确认deleted字段值。
• 数据库字段关联不匹配：检查BOOKING_LEG表的BELONGS_TO字段是否正确关联BOOKINGS表的ID字段，注意数据库的大小写敏感性（比如字段名是否大小写一致）。
• 强制关联加载：即使设置了FetchType.EAGER，某些场景下JPA可能未触发关联加载。可以在查询方法上添加@EntityGraph强制加载关联实体：

  @EntityGraph(attributePaths = {"belongsTo"})
  Optional<BookingLegEntity> findByUuid(UUID id);
  

• 二级缓存干扰：如果开启了JPA二级缓存，可能缓存了旧的无关联数据。尝试清空缓存或暂时关闭二级缓存测试。
• 事务上下文缺失：非事务环境下，部分JPA实现不会自动加载EAGER关联。确保调用findByUuid的方法被@Transactional注解修饰。
• equals/hashCode方法问题：如果近期修改过两个实体的equals或hashCode方法，可能导致JPA无法正确识别关联关系，检查方法实现是否合理。

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