如何通过Gson将HQL查询的Java User列表转为正确键值对JSON？

这个问题我之前也碰到过，核心原因很明确：当你用select id,name from User这种HQL语句时，Hibernate并不会返回User实体对象，而是返回Object数组（数组里的每个元素对应你查询的一个字段），所以Gson会把这些数组直接序列化成[1, "Room"]这种格式，而不是你想要的键值对对象。

下面给你几个可行的修正方案，按需选择：

方案1：使用构造函数投影（推荐） #

在你的User类中添加一个包含id和name的构造函数（同时要保留无参构造函数，Hibernate需要它来实例化对象）：

// User类新增构造函数
public User(Long id, String name) {
    this.id = id;
    this.name = name;
}

// 必须保留无参构造函数
public User() {}

然后修改你的HQL查询语句，明确指定通过构造函数创建User对象：

String queryString = "select new User(id, name) from User where unit=:name";
Query query = sessionFactory.getCurrentSession().createQuery(queryString);
query.setParameter("name", name);
List<User> users = query.list();

这样查询返回的就是完整的User对象实例，Gson序列化后自然会生成你期望的键值对格式JSON。

方案2：使用DTO（数据传输对象） #

如果不想修改原有的User实体类，可以创建一个专门的DTO类来承载查询结果：

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

    public UserDTO(Long id, String name) {
        this.id = id;
        this.name = name;
    }

    // 必须添加getter方法，Gson需要通过getter读取字段值
    public Long getId() {
        return id;
    }

    public String getName() {
        return name;
    }
}

然后修改查询语句，指定返回DTO对象：

// 注意要写全DTO的包路径
String queryString = "select new com.yourpackage.UserDTO(id, name) from User where unit=:name";
Query query = sessionFactory.getCurrentSession().createQuery(queryString);
query.setParameter("name", name);
List<UserDTO> users = query.list();

后续用Gson序列化这个List<UserDTO>，就能得到符合要求的JSON格式。

方案3：使用ResultTransformer映射结果 #

Hibernate提供了ResultTransformer可以直接把查询结果映射到实体对象上，不需要额外构造函数：

String queryString = "select id as id, name as name from User where unit=:name";
Query query = sessionFactory.getCurrentSession().createQuery(queryString);
// 把查询结果映射到User类
query.setResultTransformer(Transformers.aliasToBean(User.class));
List<User> users = query.list();

注意这里的查询字段别名要和User类的属性名完全一致，这样Hibernate才能正确映射字段值到对象属性上。

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