基于@NamedNativeQuery与@SqlResultSetMapping，如何让仓库识别非实体查询方法

我来帮你捋清楚这个场景的完整解决步骤，其实Spring Data JPA完全支持用非实体类接收原生查询的结果，关键是把几个注解的搭配逻辑搞对就行：

1. 完善非实体类CarLimitDelta的定义 #

首先你的CarLimitDelta作为结果接收类，不需要加@Entity这类实体注解，但要保证它有匹配查询结果列的构造方法（或者公开字段+setter，不过构造方法更推荐，避免空指针问题）。比如你的查询返回car_id、limit_value、delta三个字段，那类可以这么写：

public class CarLimitDelta {
    private Long carId;
    private Integer limitValue;
    private BigDecimal delta;

    // 构造方法参数顺序要和后面结果集映射的列顺序一致
    public CarLimitDelta(Long carId, Integer limitValue, BigDecimal delta) {
        this.carId = carId;
        this.limitValue = limitValue;
        this.delta = delta;
    }

    // 可选：getter方法，方便后续获取数据
    public Long getCarId() { return carId; }
    public Integer getLimitValue() { return limitValue; }
    public BigDecimal getDelta() { return delta; }
}

2. 配置@SqlResultSetMapping映射规则 #

这个注解用来定义SQL查询结果和非实体类的映射关系，必须放在任意一个实体类上（因为非实体类不能加JPA的映射注解），比如你项目里的Car实体类：

@Entity
@SqlResultSetMapping(
    name = "CarLimitDeltaMapping", // 这个名字要和后面的命名查询对应
    classes = @ConstructorResult(
        targetClass = CarLimitDelta.class, // 指定要映射的非实体类
        columns = {
            @ColumnResult(name = "car_id", type = Long.class), // SQL返回的列名+对应类型
            @ColumnResult(name = "limit_value", type = Integer.class),
            @ColumnResult(name = "delta", type = BigDecimal.class)
        }
    )
)
public class Car {
    // 你的Car实体原有代码...
}

⚠️ 注意：@ColumnResult里的name必须和你SQL查询中返回的列别名完全一致（包括大小写，取决于你的数据库配置）。

3. 定义@NamedNativeQuery原生查询 #

同样，这个注解也要放在实体类上（比如还是Car实体），用来关联你的SQL语句和上面的结果集映射：

@Entity
@SqlResultSetMapping(...) // 上面的映射代码
@NamedNativeQuery(
    name = "CarLimitDelta.getCarLimitDelta", // 命名规则：[非实体类名].[仓库方法名]
    query = "SELECT c.id AS car_id, " +
            "l.limit_val AS limit_value, " +
            "CASE WHEN l.current_val > l.limit_val THEN l.current_val - l.limit_val ELSE 0 END AS delta " +
            "FROM car c JOIN car_limit l ON c.id = l.car_id " +
            "WHERE ...", // 你的查询条件
    resultSetMapping = "CarLimitDeltaMapping" // 关联前面定义的结果集映射名称
)
public class Car {
    // 你的Car实体原有代码...
}

4. 让仓库接口识别查询方法 #

接下来定义仓库接口，不需要继承JpaRepository（因为不是实体），只需要用@Repository标记，然后通过@Query关联上面的命名查询，或者直接用方法名匹配：

方式一：用@Query显式关联 #

@Repository
public interface CarLimitDeltaRepository {
    @Query(nativeQuery = true, name = "CarLimitDelta.getCarLimitDelta")
    List<CarLimitDelta> getCarLimitDelta();
}

方式二：方法名自动匹配 #

因为我们的命名查询名字是CarLimitDelta.getCarLimitDelta，Spring Data JPA会自动匹配仓库里同名的方法，所以也可以省略@Query：

@Repository
public interface CarLimitDeltaRepository {
    List<CarLimitDelta> getCarLimitDelta();
}

额外注意事项 #

• 如果你的查询需要参数，可以在SQL里用命名参数（比如:carId），然后仓库方法里用@Param注解对应：

  // 命名查询的query改成：WHERE c.id = :carId
  List<CarLimitDelta> getCarLimitDelta(@Param("carId") Long carId);
  

• 如果不想用构造方法，也可以用@FieldResult映射到类的公开字段，但需要保证字段名和列名对应（或者用name指定列名），不过构造方法的方式更安全，避免字段未初始化的问题。

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