Spring Boot JPA多表关联查询返回数据报错解决方法

你遇到的Cannot createTypedQuery for query with more than one return报错由两个核心问题导致：

1. @EntityResult的设计目标是映射完整的JPA托管实体，要求返回实体对应的所有持久化字段，即便你手动配置了部分@FieldResult，JPA实现仍会尝试实例化完整实体对象，缺失字段会直接触发映射失败；另外JDBC结果集无法识别a.id这类带表别名前缀的列名，你之前的字段映射配置本身就无法正确取值。
2. 你在Repository方法中同时声明nativeQuery = true并绑定多实体返回的命名查询时，Spring Data JPA会默认尝试将结果映射为单个实体类型，一次返回三个不同实体的片段时，框架无法推断单个返回类型，自然无法生成TypedQuery。

• Repository中定义关联查询方法是完全符合规范的实践：JPA规范本身就不支持在实体类中直接持有EntityManager执行查询，实体类的定位是领域数据载体，所有数据库查询逻辑归属Repository/DAO层是标准分层设计，你将和Device强关联的查询放在Device对应Repository中完全合理，不需要硬将查询逻辑塞进实体类，那种在实体类中通过静态方法获取EntityManager的写法才是违反分层规范的取巧方案。
• 返回值不要用List<Object>或List<Object[]>：这类无类型标记的返回值需要手动按下标取值、做类型转换，类型不安全且维护成本极高，正确的返回值应该是自定义业务DTO或投影接口的集合。

推荐使用@ConstructorResult配合自定义DTO实现，完全遵循JPA标准，不依赖Spring Data专属特性，架构整洁无魔法值。

第一步：定义业务DTO #

根据你实际需要的字段定义不可变DTO，不要使用JPA托管实体接收跨表零散字段（避免后续脏检查意外更新数据库的风险）：

// 可放置在业务dto包下，字段类型根据实际数据库字段类型调整
public record DeviceMeasureData(
    Long deviceId,
    String deviceCode,
    String deviceManufacturer,
    LocalDateTime dateOfMeasure,
    Long componentId,
    String componentSerialNumber,
    BigDecimal componentMeasure
) {}

第二步：调整命名查询与结果集映射 #

首先修改原生SQL，给所有返回字段设置无歧义的别名（JDBC结果集无法识别表别名前缀，必须给字段起独立别名）：

@NamedNativeQuery(
        name = "Device.getMeasuresAndDates",
        query = """
        select a.id as device_id, 
        a.device as device_code,
        a.deviceManufacturer as device_manufacturer, 
        b.dateOfMeasure as measure_date, 
        c.Id as component_id, 
        c.componentSerialNumber as component_serial, 
        c.ComponentMeasure as component_measure
        from devices a inner join measures b on b.device_id = a.id
        inner join instruments c on c.id = b.instrument_id
        where a.device = :device
        order by b.dateOfMeasure, c.componentSerialNumber
        """,
        resultSetMapping = "MeasuresAndDatesMapping"
)

替换原来的@EntityResult配置，改用@ConstructorResult映射DTO构造器：

@SqlResultSetMapping(
        name = "MeasuresAndDatesMapping",
        classes = @ConstructorResult(
                targetClass = DeviceMeasureData.class,
                columns = {
                        @ColumnResult(name = "device_id", type = Long.class),
                        @ColumnResult(name = "device_code", type = String.class),
                        @ColumnResult(name = "device_manufacturer", type = String.class),
                        @ColumnResult(name = "measure_date", type = LocalDateTime.class),
                        @ColumnResult(name = "component_id", type = Long.class),
                        @ColumnResult(name = "component_serial", type = String.class),
                        @ColumnResult(name = "component_measure", type = BigDecimal.class)
                }
        )
)

第三步：调整Repository方法 #

移除冗余的nativeQuery = true声明（绑定@NamedNativeQuery时框架会自动识别为原生查询），返回值直接使用定义好的DTO类型：

@Query(name = "Device.getMeasuresAndDates") 
List<DeviceMeasureData> getMeasuresAndDates(@Param("device") String device);

如果你不需要严格遵循纯JPA规范，可以使用Spring Data JPA的接口投影简化配置，不需要写@SqlResultSetMapping：

1. 定义投影接口，方法名和SQL返回列的驼峰命名对应：

public interface DeviceMeasureProjection {
    Long getDeviceId();
    String getDeviceCode();
    String getDeviceManufacturer();
    LocalDateTime getMeasureDate();
    Long getComponentId();
    String getComponentSerialNumber();
    BigDecimal getComponentMeasure();
}

2. Repository方法直接返回List<DeviceMeasureProjection>即可。

你之前猜测的「必须返回全量字段才能用@EntityResult」是正确的，@EntityResult映射的实体会被JPA纳入持久化上下文管理，如果你只查询部分字段，未查询的字段会被赋值为null，后续如果误调用save方法，会直接把数据库中对应字段更新为null，存在严重的数据安全风险。所有跨表查询非完整实体字段的场景，一律使用DTO/投影接收结果，不要用托管实体。

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