Hibernate枚举字段反序列化异常：查询结果RoleType为null

问题根源 #

1. 父类未配置映射标识：User类是普通类，未添加@MappedSuperclass注解，Hibernate无法识别父类中的roleType字段，不会将其映射到数据库表，查询时自然不会加载该字段值。
2. 枚举映射规则缺失：即使父类被正确识别，Hibernate也需要明确的枚举映射规则，否则无法将数据库中的值转换为枚举实例。
3. 枚举构造冗余：枚举中定义的无参构造无意义（枚举实例已通过有参构造初始化），可能干扰Hibernate的实例化逻辑。

具体修复步骤 #

1. 将User类标记为映射超类 #

修改User类，添加@MappedSuperclass注解，让Hibernate识别父类字段并映射到子类实体的表中，同时补充字段的Getter/Setter方法：

import jakarta.persistence.MappedSuperclass;
import java.io.Serializable;

@MappedSuperclass
public class User implements Serializable {
    protected String email;
    protected String name;
    protected RoleType roleType;
    
    public enum RoleType implements Serializable {
        NORMAL("Normal"),
        ADMIN("Admin");

        private final String type;

        private RoleType(String type) {
            this.type = type;
        }

        public String getType() {
            return type;
        }
    }

    // 补充所有字段的Getter/Setter
    public String getEmail() { return email; }
    public void setEmail(String email) { this.email = email; }
    public String getName() { return name; }
    public void setName(String name) { this.name = name; }
    public RoleType getRoleType() { return roleType; }
    public void setRoleType(RoleType roleType) { this.roleType = roleType; }
}

2. 配置枚举字段的映射规则 #

根据数据库存储的枚举值类型，选择对应的映射方式：

情况一：数据库存储枚举名称（如"NORMAL"、"ADMIN"）

在roleType字段上添加@Enumerated(EnumType.STRING)注解：

import jakarta.persistence.Enumerated;
import jakarta.persistence.EnumType;

@MappedSuperclass
public class User implements Serializable {
    // ...其他字段

    @Enumerated(EnumType.STRING)
    protected RoleType roleType;

    // ...Getter/Setter
}

情况二：数据库存储枚举的type值（如"Normal"、"Admin"）

自定义属性转换器实现数据库值与枚举实例的转换：

• 创建转换器类：

import jakarta.persistence.AttributeConverter;
import jakarta.persistence.Converter;

@Converter(autoApply = true)
public class RoleTypeConverter implements AttributeConverter<User.RoleType, String> {

    @Override
    public String convertToDatabaseColumn(User.RoleType roleType) {
        return roleType == null ? null : roleType.getType();
    }

    @Override
    public User.RoleType convertToEntityAttribute(String dbValue) {
        if (dbValue == null) return null;
        for (User.RoleType role : User.RoleType.values()) {
            if (role.getType().equals(dbValue)) {
                return role;
            }
        }
        throw new IllegalArgumentException("未知角色类型：" + dbValue);
    }
}

• 在roleType字段上添加转换注解：

import jakarta.persistence.Convert;

@MappedSuperclass
public class User implements Serializable {
    // ...其他字段

    @Convert(converter = RoleTypeConverter.class)
    protected RoleType roleType;

    // ...Getter/Setter
}

3. 确认UserEntity的正确性 #

UserEntity作为实体类，只需确保继承自标注@MappedSuperclass的User类即可：

import jakarta.persistence.Entity;
import jakarta.persistence.Table;

@Entity
@Table(name = "User")
public class UserEntity extends User {
    public UserEntity() {
        super();
    }
    public UserEntity(User user) {
        super(user);
    }
}

4. 验证查询逻辑 #

原查询逻辑无需修改，调整后roleType字段将被正确加载：

Criteria c = session().createCriteria(UserEntity.class);
c.add(Restrictions.eq("email", email));
User user = (User) c.uniqueResult();
return user;

内容的提问来源于stack exchange，提问作者Harsh Kanakhara