JPA/Hibernate非预期类转换错误排查求助

这个报错的核心原因是原生SQL查询默认返回Object[]数组（数组元素对应查询结果的每一列），而非你期望的TrackedSerial实体对象，和Hibernate反射机制无关，是原生查询的默认行为导致的。以下是具体解决方法：

方法1：通过@SqlResultSetMapping配置实体映射 #

在TrackedSerial实体类上定义结果集映射，明确告诉Hibernate如何将原生查询结果转换为实体：

@Entity
@Table(name = "DMU_TRACKED_SERIAL")
// 定义结果映射，指定映射到TrackedSerial实体
@SqlResultSetMapping(
    name = "TrackedSerialResultMapping",
    entities = @EntityResult(entityClass = TrackedSerial.class)
)
// 关联命名原生查询与结果映射
@NamedNativeQuery(
    name = "getUnimportedTrackedSerials",
    query = "SELECT * FROM DMU_TRACKED_SERIAL WHERE [你的查询条件]",
    resultSetMapping = "TrackedSerialResultMapping"
)
public class TrackedSerial {
    // 原有字段
    // 新增字段的注解配置
    @Column(name = "CREATED_TS")
    private LocalDateTime createdTs;
    
    @Column(name = "MODIFIED")
    private LocalDateTime modified;
    
    // getter/setter方法
}

方法2：执行查询时指定结果类型（JPA 2.1+支持） #

如果是通过EntityManager手动执行命名查询，直接指定返回的实体类型即可：

List<TrackedSerial> serials = entityManager
    .createNamedQuery("getUnimportedTrackedSerials", TrackedSerial.class)
    .getResultList();

注意：这种方式要求原生SQL查询的列名（或别名）必须和TrackedSerial实体的字段名（或@Column注解指定的列名）完全匹配，否则会出现字段映射失败的情况。

额外排查点 #

• 确认原生SQL是否查询了实体类的所有必要字段：如果用SELECT *则无需担心，如果是指定列查询，必须包含CREATED_TS、MODIFIED以及其他实体字段，否则Hibernate无法构建完整的实体对象。
• 检查命名查询的名称拼写是否和代码中调用的完全一致，避免因名称不匹配导致的隐式错误。

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