Spring Data JDBC中DTO的AggregateReference未填充问题咨询

问题现象 #

• 带@Table注解的实体类Product，通过仓库的findAll()方法加载时，AggregateReference<ProductType,Long>类型的productType字段能正常填充
• 结构完全一致但未加@Table的ProductDTO，通过findAllBy()方法查询时，productType字段为null；手动添加@Query指定查询语句后，该字段又能正常填充

原因分析 #

1. 实体与DTO的处理逻辑差异 #

Spring Data JDBC对带@Table注解的聚合根实体有特殊处理逻辑：框架会识别AggregateReference这类专属类型，自动完成数据库字段到该类型实例的转换（比如将product_type列的数值封装为AggregateReference对象）。

而无@Table的DTO属于投影（Projection），默认情况下框架只会做基础的属性映射，不会主动识别AggregateReference这种框架特定类型，因此不会触发转换逻辑，导致字段值为null。

2. @Query的触发机制 #

当手动指定@Query执行SQL时，框架会直接根据结果集进行字段映射。此时只要查询结果的列名与DTO字段名匹配（比如product_type对应productType），Spring Data JDBC会调用内置的类型转换器，将数值转换为AggregateReference实例，从而完成字段填充。

解决方案 #

• 方案一：如果业务允许，给ProductDTO添加@Table注解，让框架将其当作聚合根处理，自动识别并转换AggregateReference类型字段
• 方案二：保持ProductDTO无@Table注解，手动为findAllBy()方法添加@Query，指定完整查询语句，确保结果列名与DTO字段名匹配
• 方案三：自定义类型转换器，注册到Spring容器中，让框架在处理投影时也能自动将数值类型转换为AggregateReference实例

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