Spring Data JDBC一对一关联自定义查询无法加载关联对象问题

我来帮你梳理下这个问题的根源和解决方案——你遇到的情况其实是Spring Data JPA在处理自定义SQL查询时，不会自动推断并加载关联实体，而默认的findById方法会利用JPA的元数据配置自动处理关联属性的加载。结合你提到的需要PostgreSQL特定语法、不想写超长全字段SQL的需求，这里有几个靠谱的解决思路：

1. 用JPQL的JOIN FETCH显式加载一对一关联 #

如果你的自定义查询逻辑可以用JPQL实现（即使包含PostgreSQL特定函数，JPQL也支持通过FUNCTION()调用数据库原生函数），这是最优雅的方案。JOIN FETCH会让JPA在一次查询中同时加载主实体和关联的一对一实体，无需手动写全字段：

@Repository
public interface ProjectRepository extends CrudRepository<Project, Long> {
    @Query("select p from Project p join fetch p.projectRecipient where p.projectId = :projectId")
    Optional<Project> findProjectWithRecipientById(@Param("projectId") Long projectId);
}

要是你需要PostgreSQL的模糊查询（比如ILIKE），可以这样写JPQL：

@Query("select p from Project p join fetch p.projectRecipient where p.projectName like FUNCTION('ILIKE', concat('%', :keyword, '%'))")
List<Project> findProjectsWithRecipientByNameLike(@Param("keyword") String keyword);

2. 用@EntityGraph强制加载关联属性 #

如果必须使用原生SQL（比如复杂的PostgreSQL特定语法无法用JPQL表达），可以在自定义查询方法上添加@EntityGraph注解，指定需要加载的关联属性。这样JPA会在查询主实体后自动触发关联实体的加载，或者通过左连接一次性加载：

@Repository
public interface ProjectRepository extends CrudRepository<Project, Long> {
    @EntityGraph(attributePaths = {"projectRecipient"})
    @Query(value = "select p.* from project p inner join projectrecipient pr on pr.project = p.projectid where p.projectid = :projectId", nativeQuery = true)
    Optional<Project> findProjectWithRecipientById(@Param("projectId") Long projectId);
}

这个方案既保留了原生SQL的灵活性，又不用写冗长的全字段查询语句，完美适配你的需求。

3. 临时方案：设置关联属性为FetchType.EAGER（不推荐） #

如果你只是临时需要快速解决问题，可以把projectRecipient的关联加载类型改为EAGER，这样每次查询Project都会自动加载关联的ProjectRecipient：

@OneToOne(fetch = FetchType.EAGER)
@With private final ProjectRecipient projectRecipient;

但要注意：这种方式是全局生效的，所有查询Project的操作都会加载这个关联属性，可能导致不必要的性能损耗，所以只适合应急场景，不推荐长期使用。

为什么findById能正常加载？ #

默认的findById方法会基于JPA的实体映射元数据生成查询，它要么会在主查询中包含关联实体的所有字段（如果是EAGER加载），要么会在你首次访问projectRecipient时触发懒加载查询（如果是LAZY加载）。而你的自定义SQL只查询了p.*，没有返回projectRecipient的字段，JPA无法自动识别并加载这个关联对象，所以就出现了只有一对多属性被加载的情况。

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