JPA+MySQL OneToMany映射排除字段的高效关联查询方案

你写的JPQL构造器投影语法本身存在逻辑问题：JPQL的new 类名(参数)构造器表达式仅支持传入平面标量字段作为构造参数，不支持直接传入OneToMany类型的集合关联属性。Hibernate在解析这类语句时，无法自动将一对多关联产生的多行结果集聚合为Set集合传入构造器，最终生成的SQL片段存在语法错误，才会抛出你看到的如下异常：

You have an error in your SQL syntax; check the manual that corresponds to your MySQL server version for the right syntax to use near '. as col_12_0_ from documents document0_ inner join custom_properties customprop' at line 1

这也是为什么去掉d.customProperties参数后语句可以正常运行。

核心目标是：只查必要字段、一次查询加载关联集合避免N+1问题、不扫描冗余大字段。 #

方案1：实体图+字段懒加载（最优，性能最高） #

这是JPA标准支持的方案，开发成本最低，性能最好，最终只会生成一条SQL，仅查询你指定的字段和关联数据。

1. 首先给Document实体中不需要查询的大字段（如contents）配置懒加载，避免默认查询时加载冗余字段：

   // 大字段、不常用字段统一配置懒加载
   @Lob
   @Basic(fetch = FetchType.LAZY)
   private String contents;
   

2. 定义Repository查询方法，用@EntityGraph指定需要加载的字段和关联集合，Hibernate会自动生成仅包含这些字段的查询语句，同时通过JOIN加载关联的CustomProperty，不会产生N+1问题：

   @EntityGraph(attributePaths = {"id", "title", "customProperties"})
   @Query("select d from Document d")
   List<Document> findRequiredDocWithProperties();
   

如果需要分页，必须单独指定count查询，避免Hibernate加载全量数据做内存分页：

@EntityGraph(attributePaths = {"id", "title", "customProperties"})
@Query(
    value = "select d from Document d",
    countQuery = "select count(d.id) from Document d"
)
Page<Document> pageRequiredDocWithProperties(Pageable pageable);

方案2：接口投影+JOIN FETCH（无需修改实体配置） #

如果你不想修改实体的字段加载策略，可以用Spring Data JPA的接口投影功能，显式声明你需要的字段，配合join fetch一次性加载关联集合，同样不会查询冗余字段。

1. 定义投影接口，仅声明你需要的字段：

   public interface DocumentSimpleProjection {
       Long getId();
       String getTitle();
       Set<CustomPropertyProjection> getCustomProperties();
   
       interface CustomPropertyProjection {
           // 按需声明CustomProperty中需要查询的字段即可
           Long getId();
           String getPropertyKey();
           String getPropertyValue();
       }
   }
   

2. 编写查询语句，用left join fetch加载关联集合：

   @Query("select d from Document d left join fetch d.customProperties")
   List<DocumentSimpleProjection> findDocWithProjection();
   

• 给CustomProperty表的外键字段document_id创建数据库索引，关联查询时可以大幅降低JOIN的耗时
• 所有大字段、低频访问字段统一设置为FetchType.LAZY，避免默认查询时扫描不必要的字段占用磁盘IO和网络带宽
• 非必要不要直接调用JPA默认的findAll()方法，该方法会查询实体所有映射字段，遇到全局EAGER关联时还会自动做多表关联，性能极差
• 如果CustomProperty实体中也存在大字段，同样可以通过懒加载、投影的方式仅查询必要字段，进一步减少数据传输量

内容的提问来源于stack exchange，提问作者Martin Kršek