Java Spring映射对象含结果集未返回属性报错，求其他解决方法

问题背景 #

现有User实体类：

@Id
private long id;
private String name;
private String email;
private int age;

执行仅查询id和name的SQL时：

select user.name, user.id 
from user 
where "some condition";

将结果映射到User类时抛出Column 'email' not found错误。目前已有的解决方式是在SQL中补全null email, null age，或者新建仅含id和name的实体类。

其他解决办法 #

1. 利用实体类的构造函数映射 #

在User类中添加一个仅接收id和name的构造函数，同时保留JPA要求的无参构造函数：

public User(long id, String name) {
    this.id = id;
    this.name = name;
}

public User() {}

之后使用JPQL查询时，直接调用该构造函数实例化对象：

String jpql = "SELECT new com.yourpackage.User(u.id, u.name) FROM User u WHERE ...";
List<User> users = entityManager.createQuery(jpql, User.class).getResultList();

Hibernate会通过指定的构造函数创建User实例，不会尝试映射未查询的email和age字段。

2. 使用Spring Data JPA的投影接口 #

定义一个仅包含目标字段 getter 方法的投影接口：

public interface UserProjection {
    long getId();
    String getName();
}

在Repository接口中返回该类型的结果集，支持方法名匹配条件或自定义SQL：

public interface UserRepository extends JpaRepository<User, Long> {
    // 方法名匹配查询条件
    List<UserProjection> findByXXX(...);

    // 自定义原生SQL
    @Query(value = "select user.id, user.name from user where ...", nativeQuery = true)
    List<UserProjection> findUsersWithIdAndName();
}

Spring Data JPA会动态生成代理类实现该接口，自动映射查询结果，无需修改原User实体。

3. 用@SqlResultSetMapping自定义结果映射 #

在User实体类上添加注解，明确指定结果集的映射规则：

@Entity
@SqlResultSetMapping(
    name = "UserIdNameMapping",
    classes = @ConstructorResult(
        targetClass = User.class,
        columns = {
            @ColumnResult(name = "id", type = long.class),
            @ColumnResult(name = "name", type = String.class)
        }
    )
)
public class User {
    // 实体属性...
}

查询时引用这个映射名称：

Query query = entityManager.createNativeQuery(
    "select user.id, user.name from user where ...",
    "UserIdNameMapping"
);
List<User> users = query.getResultList();

这种方式适合原生SQL场景，精准控制字段与实体的映射关系。

4. 使用Map接收查询结果 #

如果不需要强类型实体，也可以直接用Map<String, Object>接收结果：

@Query(value = "select user.name, user.id from user where ...", nativeQuery = true)
List<Map<String, Object>> findUsersAsMap();

后续可从Map中直接提取id和name字段，灵活性高但需要自行处理类型转换。

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