为什么Hibernate的@OneToOne关联查询未自动生成left outer join？

问题根因 #

• 第一是双向@OneToOne映射配置错误：你在两个实体上都加了@JoinColumn注解，相当于定义了两个独立的单向一对一关联，Hibernate无法识别这是一对双向绑定的关联关系，自然不会自动触发关联查询。
• 第二是Spring Data JPA默认的findById方法不会主动做关联抓取：即使映射配置正确，默认的查询方法也只会查主表，然后根据关联的加载策略单独发起查询拉取关联实体，不会自动生成JOIN语句。
• 第三是缺少属性声明导致非预期的空返回：@OneToOne默认optional = true允许关联侧为空，但因为你的双向映射冲突，Hibernate无法判断关联规则，会默认按关联必须存在的逻辑处理，所以当LoanEc表无对应数据时，整个查询直接返回空。

解决步骤 #

1. 修正双向关联配置 #

双向@OneToOne只能有一方作为关联维护方（持有外键的一方），另一方必须用mappedBy指向维护方的关联属性，不能重复配置@JoinColumn。按你的需求修改LoanEc实体的关联配置：

@Entity
@Table(name = "LOAN_EC")
public class LoanEc {
    @Id
    Long fLoanId;

    // 用mappedBy指向LoanOrder里的loanEc属性，表明LoanOrder是关联维护方
    @OneToOne(mappedBy = "loanEc", fetch = FetchType.LAZY)
    LoanOrder loanOrder;
}

2. 主动指定关联抓取逻辑 #

要让Hibernate生成左连接查询，有两种常用方案：

方案一：用@EntityGraph注解标注查询方法

public interface ECRepository extends Repository<LoanOrder,Long>{
    // 指定要抓取的关联属性，自动生成左连接查询
    @EntityGraph(attributePaths = "loanEc")
    Optional<LoanOrder> findById(Long id);
    
    void save(LoanOrder loanOrder);
}

方案二：自定义JPQL查询，显式写左连接抓取

public interface ECRepository extends Repository<LoanOrder,Long>{
    @Query("SELECT lo FROM LoanOrder lo LEFT JOIN FETCH lo.loanEc WHERE lo.loanId = :id")
    Optional<LoanOrder> findByIdWithLoanEc(@Param("id") Long id);
    
    void save(LoanOrder loanOrder);
}

修改后再调用对应的查询方法，就会生成你预期的左关联SQL，且LoanEc无对应数据时也会正常返回LoanOrder实体，关联属性为null。

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