Spring Data JPA中EntityManager的createQuery()能否返回接口类型实例？

这确实是个容易踩的坑！你遇到的问题核心很明确：直接使用EntityManager的createQuery()本身并不支持返回接口类型的代理实例，而Spring Data JPA的Repository层帮你做了额外的封装处理，这才是两者表现不同的原因。

为什么Spring Data JPA Repository可以？ #

Spring Data JPA在Repository接口的@Query方法上，实现了**接口投影（Interface Projection）**的增强功能：当你指定返回一个接口类型时，它会在运行时动态生成该接口的代理类，自动把查询结果的字段映射到接口对应的getter方法上。这个功能是Spring Data JPA额外提供的，不属于JPA规范本身的范畴。

你的Repository代码能正常运行，就是因为Spring帮你完成了代理实例的创建和结果映射：

public interface DcRepository extends JpaRepository<DcMotor, Long> { 
    @Query("select dc.id, dc.manufacturer from DcMotor dc ") 
    List<DcListInterface> testQuery(); 
}

为什么EntityManager直接调用会失败？ #

EntityManager是JPA规范定义的原生API，它只支持返回以下几种类型的结果：

• 实体类实例
• 基本数据类型（如String、Long等）
• Tuple对象
• 自定义DTO类（需要提供匹配查询字段的构造方法）

它并没有内置生成接口代理的逻辑，所以你直接把接口类型传给createQuery()时，Hibernate作为JPA实现就会抛出QueryTypeMismatchException，因为它不知道怎么把查询结果封装成一个接口的实例。

解决方案 #

如果必须使用EntityManager来执行查询，有两种常见的处理方式：

1. 手动映射结果到接口实例

先查询返回Object[]或者Tuple，然后自己通过动态代理或者手动创建接口实现类的方式来封装结果。比如用Java原生动态代理的示例：

@Test
@Transactional(readOnly = true)
void test() {
    // 先查询返回Object数组
    TypedQuery<Object[]> query = em.createQuery(
        "select dc.id, dc.manufacturer from DcMotor dc ", 
        Object[].class
    );
    List<Object[]> resultList = query.getResultList();
    
    // 手动映射为接口实例
    List<DcListInterface> dcList = resultList.stream()
        .map(row -> (DcListInterface) Proxy.newProxyInstance(
            DcListInterface.class.getClassLoader(),
            new Class[]{DcListInterface.class},
            (proxy, method, args) -> {
                switch (method.getName()) {
                    case "getId":
                        return row[0];
                    case "getManufacturer":
                        return row[1];
                    default:
                        throw new UnsupportedOperationException("Unsupported method: " + method.getName());
                }
            }
        ))
        .collect(Collectors.toList());
    
    assertThat(dcList).isNotNull();
}

2. 改用DTO类替代接口

定义一个和接口字段匹配的DTO类（带对应的构造方法），让EntityManager返回这个DTO，再根据需要转换为接口类型：

// 定义DTO类
public class DcListDto implements DcListInterface {
    private Long id;
    private String manufacturer;

    // 匹配查询字段的构造方法
    public DcListDto(Long id, String manufacturer) {
        this.id = id;
        this.manufacturer = manufacturer;
    }

    // 实现接口的getter方法
    @Override
    public Long getId() {
        return id;
    }

    @Override
    public String getManufacturer() {
        return manufacturer;
    }
}

// 修改后的测试方法
@Test
@Transactional(readOnly = true)
void test() {
    TypedQuery<DcListDto> query = em.createQuery(
        "select new com.yourpackage.DcListDto(dc.id, dc.manufacturer) from DcMotor dc ", 
        DcListDto.class
    );
    List<DcListDto> resultList = query.getResultList();
    // 如果需要接口类型，可以直接转换
    List<DcListInterface> dcList = new ArrayList<>(resultList);
    
    assertThat(dcList).isNotNull();
}

当然，如果不是必须用EntityManager，直接用Spring Data JPA的Repository方式是最省心的——毕竟Spring已经帮你处理了所有映射细节。

内容来源于stack exchange