Spring Boot读取MongoDB中int字段为null的文档时抛出异常

首先明确：MongoDB完全允许存储null值，不管是显式指定字段为null，还是字段缺失，都是合法的文档格式，所以存储环节是没有问题的，问题出在Spring Boot（准确说是Spring Data MongoDB）的实体映射逻辑上。

为什么会抛出Parameter age must not be null!异常？ #

从你给出的异常信息和实体类片段（final p...）来看，大概率是以下两种情况：

1. 字段类型为基本类型int而非包装类Integer #

如果你的age字段定义是：

final int age;

基本类型int无法承载null值，当Spring Data MongoDB试图把MongoDB文档中的null映射到这个字段时，就会触发非法参数异常——因为基本类型不能为null。

2. final字段的构造器注入限制 #

即使你用了包装类Integer，如果age是final修饰的字段，@Data注解生成的构造器会把age作为必填参数。而Spring Data MongoDB在实例化实体时，会尝试通过构造器注入值，当文档中age为null时，就会因为构造器参数不允许null而抛出异常。

解决方案 #

针对不同场景，你可以选择以下方案：

方案1：修改字段类型与修饰符 #

如果业务允许age为null且不需要final修饰，直接把字段改成非final的包装类：

@Data
@Document
public class User {
    private String user;
    private Integer age; // 用Integer替代int，去掉final
}

这样Spring Data可以正常处理null值，映射不会出错。

方案2：保留final字段，允许构造器参数为null #

如果必须保留final修饰，需要显式定义构造器，并通过@Nullable注解标记age参数允许为null：

@Data
@Document
public class User {
    private final String user;
    @Nullable
    private final Integer age;

    // 显式构造器，标记age参数可为null
    public User(String user, @Nullable Integer age) {
        this.user = user;
        this.age = age;
    }
}

同时确保你的项目引入了Spring的Nullable注解（通常spring-core包自带），这样Spring Data就会允许传入null值到构造器中。

方案3：标记字段为非必填 #

如果age字段是可选的，还可以加上@Field(required = false)注解，明确告诉Spring Data这个字段不是必须存在的：

@Data
@Document
public class User {
    private String user;
    @Field(required = false)
    private Integer age;
}

额外检查 #

别忘了排查是否在age字段上误加了@NotNull这类验证注解，如果有的话，即使类型是包装类，读取时也会触发验证异常，抛出类似的“must not be null”错误。

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