Spring Data原生查询映射自定义Bean（非投影）方案求助

嘿，我来帮你搞定这个Spring Data JPA里原生查询结果映射到自定义Bean的需求！你的代码已经有了雏形，我给你补全完整的实现方案，分两种常用的方式，你可以根据自己的场景选择：

方式一：使用@SqlResultSetMapping + @ConstructorResult（适合有业务逻辑的自定义Bean） #

这种方式适合你的自定义Bean需要包含业务方法，或者你更习惯用实体类风格的DTO。

步骤1：定义自定义DTO类 #

首先创建你要映射的目标Bean，比如ActivityDto，可以提供带参构造函数（或者无参+setter，推荐带参构造更严谨）：

public class ActivityDto {
    private Long activityId;
    private String activityTitle;
    private String activityInstructions;

    // 构造函数参数顺序、类型要和查询结果的列一一对应
    public ActivityDto(Long activityId, String activityTitle, String activityInstructions) {
        this.activityId = activityId;
        this.activityTitle = activityTitle;
        this.activityInstructions = activityInstructions;
    }

    // 按需添加getter、setter和业务方法
    public Long getActivityId() {
        return activityId;
    }
    // ... 其他getter
}

步骤2：配置结果集映射 #

在对应数据库表的实体类（比如Activity，对应activities_t表）上添加@SqlResultSetMapping，名字要和你@Query里的resultSetMapping一致：

import javax.persistence.*;

@Entity
@Table(name = "activities_t")
// 定义结果集映射，关联到我们的DTO
@SqlResultSetMapping(
    name = "myQueryResultSet", // 必须和@Query中的resultSetMapping值匹配
    classes = @ConstructorResult(
        targetClass = ActivityDto.class, // 目标DTO类
        columns = {
            @ColumnResult(name = "activityId", type = Long.class), // 对应查询结果的别名
            @ColumnResult(name = "activityTitle", type = String.class),
            @ColumnResult(name = "activityInstructions", type = String.class)
        }
    )
)
public class Activity {
    // 你的实体字段映射
    @Id
    @Column(name = "id")
    private Long id;

    @Column(name = "activity_title")
    private String activityTitle;

    // 其他字段...
}

步骤3：补全Repository方法 #

注意！原生查询必须加上nativeQuery = true，否则Spring会把它当成JPQL解析，直接报错。然后补全泛型为ActivityDto：

import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.data.jpa.repository.Query;
import org.springframework.data.repository.query.Param;
import java.util.List;

public interface ActivityRepository extends JpaRepository<Activity, Long> {

    @Query(
        value = "select id as activityId, activity_title as activityTitle, activity_instructions as activityInstructions from activities_t " +
                "where case when activity_code ~ '^\\d+$' " + // 匹配纯数字的activity_code
                "then cast(activity_code as int) between :firstId and :lastActivityId end",
        nativeQuery = true, // 关键：标记为原生SQL查询
        resultSetMapping = "myQueryResultSet"
    )
    List<ActivityDto> findActivitiesBetweenIds(
        @Param("firstId") Integer firstId, 
        @Param("lastActivityId") Integer lastActivityId
    );
}

方式二：使用接口投影（简洁高效，适合只读场景） #

如果你的自定义Bean只是用来接收查询结果，不需要业务逻辑，这种方式更简单，不用写构造函数和结果集映射：

步骤1：定义投影接口 #

创建一个接口，方法名要和查询结果的别名严格对应（驼峰命名匹配，比如查询别名是activityId，接口方法是getActivityId）：

public interface ActivityProjection {
    Long getActivityId();
    String getActivityTitle();
    String getActivityInstructions();
}

步骤2：修改Repository方法 #

直接返回这个接口的列表，不需要resultSetMapping：

public interface ActivityRepository extends JpaRepository<Activity, Long> {

    @Query(
        value = "select id as activityId, activity_title as activityTitle, activity_instructions as activityInstructions from activities_t " +
                "where case when activity_code ~ '^\\d+$' " +
                "then cast(activity_code as int) between :firstId and :lastActivityId end",
        nativeQuery = true
    )
    List<ActivityProjection> findActivitiesBetweenIds(
        @Param("firstId") Integer firstId, 
        @Param("lastActivityId") Integer lastActivityId
    );
}

重要注意事项 #

• 原生查询必须加nativeQuery = true，这是很多人容易忽略的点！
• 用@ConstructorResult时，构造函数的参数顺序、类型必须和@ColumnResult完全匹配，否则会映射失败。
• 接口投影的方法名必须和查询结果的别名一致，Spring会自动通过动态代理实现接口，返回结果。
• 你的SQL里的case语句：如果activity_code不是纯数字，case的结果是null，where条件里null会被视为false，这类记录会被过滤。如果需要保留非数字的记录，可以调整为case when activity_code ~ '^\\d+$' then cast(activity_code as int) between :firstId and :lastActivityId else true end，具体看你的业务需求。

内容的提问来源于stack exchange，提问作者gene b.