JPA原生查询返回实体时非查询字段缺失报错求助

问题原因 #

当你使用原生SQL查询并期望返回Compras实体列表时，JPA（或Hibernate）要求查询结果必须包含实体映射的所有持久化字段（除非字段配置为懒加载且支持延迟初始化，但原生SQL通常不兼容这种自动处理）。如果查询结果中缺少某个实体字段（比如clasificacion_bienes_servicios），框架无法完成实体对象的实例化，就会抛出InvalidDataAccessResourceUsageException。

解决方案 #

1. 使用DTO/接口投影接收部分字段（推荐） #

如果不需要完整的Compras实体，最安全的方式是用专门的DTO类或接口投影来接收需要的字段：

方式1：DTO类

先定义包含目标字段的DTO：

public class ComprasPartialDTO {
    private Long id;
    private String compraNombre;
    // 按需添加其他需要的字段

    // 构造函数参数顺序要和SQL查询的字段顺序一致
    public ComprasPartialDTO(Long id, String compraNombre) {
        this.id = id;
        this.compraNombre = compraNombre;
    }

    // 生成getter方法
    public Long getId() { return id; }
    public String getCompraNombre() { return compraNombre; }
}

然后在ComprasRepo中编写查询：

@Query(value = "SELECT id, nombre FROM compras WHERE ...", nativeQuery = true)
List<ComprasPartialDTO> findPartialCompras();

方式2：接口投影

定义一个包含目标字段getter的接口：

public interface ComprasPartialProjection {
    Long getId();
    String getNombre();
    // 按需添加其他字段的getter
}

在Repo中使用：

@Query(value = "SELECT id, nombre FROM compras WHERE ...", nativeQuery = true)
List<ComprasPartialProjection> findPartialCompras();

2. 查询所有实体字段（必须返回完整实体时） #

如果业务逻辑要求必须返回Compras实体对象，那只能在原生SQL中查询所有字段，包括clasificacion_bienes_servicios：

@Query(value = "SELECT id, nombre, clasificacion_bienes_servicios, ... -- 列出所有实体映射的字段 FROM compras WHERE ...", nativeQuery = true)
List<Compras> findCompras();

3. 调整实体字段配置（不推荐） #

如果clasificacion_bienes_servicios字段允许为null，可以在实体类中给该字段添加@Column(nullable = true)，同时确保Hibernate允许未填充该字段。但这种方式可能导致实体处于不完整状态，后续使用时容易触发空指针异常，仅作为临时 workaround 考虑：

@Column(name = "clasificacion_bienes_servicios", nullable = true)
private String clasificacionBienesServicios;

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