SpringBoot读取MongoDB文档时遭遇InstantiationError: EmployeeType错误

问题原因 #

你遇到的java.lang.InstantiationError: EmployeeType错误，本质是Spring Data MongoDB无法直接实例化抽象类EmployeeType——它不知道应该创建哪个具体子类（原代码中的Employee/Contract）的实例来匹配MongoDB中的数据。另外你的代码存在类名冲突：@Document标注的实体类和继承EmployeeType的子类都叫Employee，这会导致编译和运行时的混淆，必须先修正这个命名问题。

解决方案：使用鉴别器注解（推荐） #

Spring Data MongoDB提供了@Discriminator和@DiscriminatorValue注解，用来标记抽象类的子类区分规则，让框架能根据MongoDB中的字段值自动实例化对应子类。

1. 修正类名冲突 #

首先把继承EmployeeType的子类重命名，比如改为FullTimeEmployee：

public class FullTimeEmployee extends EmployeeType {
    private List<String> name;
    // 添加getter、setter及构造方法
}

2. 配置抽象类与子类的鉴别器 #

在抽象类EmployeeType上添加@Discriminator，指定用来区分子类的字段名；在每个子类上用@DiscriminatorValue指定该子类对应的字段值：

// 抽象类：指定鉴别器字段名
@Discriminator(fieldName = "type")
public abstract class EmployeeType {

}

// 全职员工子类：指定鉴别值
@DiscriminatorValue("FULL_TIME")
public class FullTimeEmployee extends EmployeeType {
    private List<String> name;
    // getter、setter、构造方法
}

// 合同工子类：指定鉴别值
@DiscriminatorValue("CONTRACT")
public class Contract extends EmployeeType {
    private String name;
    // getter、setter、构造方法
}

3. 调整主实体类的字段 #

确保Employee类中的type字段与鉴别器配置一致：

@Document(collection = "employee")
public class Employee {
    @Id
    private String id;    
    @Field("type") // 与抽象类的鉴别器字段名对应
    private EmployeeType type;
    // 其他字段及getter、setter
}

4. 确保MongoDB文档结构 #

MongoDB中的文档需要包含鉴别器字段，示例如下：

{
  "_id": "12",
  "type": {
    "type": "FULL_TIME",
    "name": ["张三", "李四"]
  }
}

原理说明 #

当你用mongoTemplate.findOne查询时，Spring Data MongoDB会读取type字段中的鉴别值，匹配对应的@DiscriminatorValue，从而实例化正确的子类（如FullTimeEmployee），而不是尝试实例化抽象类EmployeeType，这样就能避免InstantiationError错误。

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