如何在Spring Boot投影接口中使用实体类并返回额外字段？

错误原因 #

Spring Data的接口动态投影仅支持返回接口类型或简单数据类型（如String、Integer、double等），无法直接返回实体类（具体类类型）。因为动态代理只能生成接口的实现类，无法自动将数据库查询结果映射到实体类实例，从而导致类型转换异常。

可行解决方案 #

方案1：使用DTO类投影（推荐） #

创建一个包含实体类和额外字段的DTO，通过构造函数接收查询结果，Spring Data会自动匹配构造函数参数完成映射。

// DTO类
public class MyProjectionDTO {
    private TableA tableA;
    private double additionalValue;

    // 构造函数参数需与查询返回的字段/实体顺序匹配
    public MyProjectionDTO(TableA tableA, double additionalValue) {
        this.tableA = tableA;
        this.additionalValue = additionalValue;
    }

    // 提供getter方法供序列化使用
    public TableA getTableA() {
        return tableA;
    }

    public double getAdditionalValue() {
        return additionalValue;
    }
}

在Repository中定义查询方法，返回该DTO：

@Repository
public interface TableARepository extends JpaRepository<TableA, Long> {
    // JPQL查询，直接返回实体和计算后的额外值
    @Query("SELECT a, (a.price * 0.8) as additionalValue FROM TableA a WHERE a.id = :id")
    List<MyProjectionDTO> findProjectionsById(@Param("id") Long id);
}

方案2：拆分实体属性到投影接口 #

如果不需要完整的TableA实体，可将实体的所需属性直接定义在投影接口中，同时添加额外字段：

public interface MyProjection {
    // 与TableA实体的getter方法名保持一致
    Long getId();
    String getName();
    BigDecimal getPrice();

    // 额外字段
    double getAdditionalValue();
}

Repository查询方法返回该接口即可：

@Query("SELECT a.id, a.name, a.price, (a.price * 0.8) as additionalValue FROM TableA a WHERE a.id = :id")
List<MyProjection> findProjectionsById(@Param("id") Long id);

方案3：通过SpEL在接口投影中返回完整实体（不推荐，易出问题） #

如果必须在接口投影中返回完整实体，可使用@Value结合SpEL表达式获取目标实体，但需确保查询语句返回完整的TableA实例：

public interface MyProjection {
    @Value("#{target}")
    TableA getTableA();

    double getAdditionalValue();
}

对应的Repository查询：

@Query("SELECT a, (a.price * 0.8) as additionalValue FROM TableA a WHERE a.id = :id")
List<MyProjection> findProjectionsById(@Param("id") Long id);

注意：这种方式依赖Spring Data的SpEL解析，部分场景下可能出现序列化或映射问题，需谨慎使用。

内容的提问来源于stack exchange，提问作者Sebastian G.