Spring Boot JPA报错Unknown SqlResultSetMapping [TaxelMapping1]排查求助

你遇到的Unknown SqlResultSetMapping [TaxelMapping1]异常，核心是没有在实体类上正确定义名为TaxelMapping1的结果集映射，或者映射的定义位置不符合JPA规范。

缺失的关键步骤 #

1. 在实体类上添加@SqlResultSetMapping定义 #

JPA要求SqlResultSetMapping必须绑定到实体类（比如你的Taxel实体），不能单独在DTO或Repository中定义。你需要在Taxel类上添加如下代码，指定映射名称和对应DTO的字段映射：

@Entity
// 定义结果集映射
@SqlResultSetMapping(
    name = "TaxelMapping1", // 必须和你查询中引用的名称完全一致
    classes = @ConstructorResult(
        targetClass = TaxelDTO.class, // 要映射的DTO类
        columns = {
            @ColumnResult(name = "id", type = Long.class), // 对应SQL返回的字段名和类型
            @ColumnResult(name = "name", type = String.class),
            // 补充你SQL查询返回的其他所有字段
        }
    )
)
public class Taxel {
    // 你的实体类原有代码
}

2. 确保查询正确引用映射名 #

如果是用@NamedNativeQuery，要明确指定resultSetMapping属性：

@Repository
public interface TaxelRepository extends JpaRepository<Taxel, Long> {
    @NamedNativeQuery(
        name = "Taxel.getTaxelDTO",
        query = "SELECT id, name FROM taxel WHERE ...", // 你的SQL语句
        resultSetMapping = "TaxelMapping1" // 关联上面定义的映射名
    )
    List<TaxelDTO> getTaxelList();
}

如果是用EntityManager执行动态SQL，要传入映射名：

List<TaxelDTO> result = entityManager.createNativeQuery(sql, "TaxelMapping1")
                                     .getResultList();

3. 验证DTO构造函数匹配 #

TaxelDTO必须有与@ColumnResult顺序、类型完全匹配的构造函数，否则即使映射找到，也会出现字段绑定失败的问题：

public class TaxelDTO {
    private Long id;
    private String name;

    // 必须和映射中columns的顺序、类型一致
    public TaxelDTO(Long id, String name) {
        this.id = id;
        this.name = name;
    }

    // getter/setter
}

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