单向关联下Spring JPA通过子属性查询实体返回Null问题

问题核心 #

在User维护的单向OneToOne关联（关联Credentials）场景中，通过currentEmail查询User始终返回Null，且不希望使用双向关联避免更新/持久化问题。

解决方案 #

1. 修正实体关联映射

首先在User实体的credentials字段上添加@JoinColumn，明确外键关系，确保JPA能正确识别两张表的关联：

@OneToOne(fetch = FetchType.EAGER, cascade = CascadeType.ALL, orphanRemoval = true)
@JoinColumn(name = "credentials_id") // 指定User表中外键列名，关联Credentials的id
private Credentials credentials;

2. 调整查询方法（二选一）

方式一：使用JPQL手动编写查询（推荐，逻辑更清晰）

在UserRepository中用@Query明确关联查询逻辑，避免方法名解析的潜在问题：

public interface UserRepository extends JpaRepository<User, UUID> {
    @Query("SELECT u FROM User u JOIN u.credentials c WHERE c.currentEmail = :email")
    Optional<User> findUserByCredentialsCurrentEmail(@Param("email") String email);
}

方式二：修正Spring Data方法名规范

原方法名前缀findUserBy不符合Spring Data的命名规范，改为findBy开头，确保方法名解析正确：

public interface UserRepository extends JpaRepository<User, UUID> {
    Optional<User> findByCredentialsCurrentEmail(String email);
}

原因说明 #

• 未指定@JoinColumn时，JPA可能生成不符合预期的外键列或中间表，导致查询时无法正确关联两张表。
• Spring Data的方法名解析在单向关联场景下存在不确定性，手动编写JPQL能确保查询逻辑的准确性。
• 原方法名的findUserBy前缀不符合规范，Spring Data无法正确解析关联属性的查询路径。

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