MongoDB 5+Spring Boot Data 2.4：如何避免插入/更新空值字段？

针对你使用Spring Boot Data 2.4 + MongoDB 5的场景，通过自定义Writing Converter确实可以实现POJO转Document时自动过滤null或空字符串字段的需求，下面是具体实现步骤和示例：

1. 实现自定义Writing Converter #

创建一个转换器类，负责将任意POJO转换为MongoDB的Document对象，同时过滤掉值为null或空字符串的字段：

import org.bson.Document;
import org.springframework.core.convert.converter.Converter;
import org.springframework.data.convert.WritingConverter;
import java.lang.reflect.Field;

@WritingConverter
public class PojoToDocumentConverter implements Converter<Object, Document> {

    @Override
    public Document convert(Object source) {
        Document document = new Document();
        Field[] fields = source.getClass().getDeclaredFields();

        for (Field field : fields) {
            field.setAccessible(true);
            try {
                Object value = field.get(source);
                // 过滤null、空字符串，可根据需求调整（比如保留全空格字符串则去掉trim()）
                if (value != null && !(value instanceof String && ((String) value).trim().isEmpty())) {
                    document.put(field.getName(), value);
                }
            } catch (IllegalAccessException e) {
                throw new RuntimeException("POJO转Document失败", e);
            }
        }
        return document;
    }
}

说明：

• @WritingConverter注解标记这是MongoDB写入操作时的转换器
• 通过反射遍历POJO的所有字段，跳过null值和空（含全空格）的字符串字段
• 非字符串类型仅过滤null值，不影响正常数值、日期等类型的字段

2. 注册转换器到Spring Data MongoDB #

编写配置类，将自定义转换器加入MongoDB的转换链：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.data.mongodb.core.convert.MongoCustomConversions;
import java.util.List;

@Configuration
public class MongoConfig {

    @Bean
    public MongoCustomConversions mongoCustomConversions() {
        return new MongoCustomConversions(List.of(new PojoToDocumentConverter()));
    }
}

3. 测试Person模型场景 #

定义Person实体类 #

public class Person {
    private String name;
    private String surname;

    // 构造器、Getter、Setter省略
    public Person(String name, String surname) {
        this.name = name;
        this.surname = surname;
    }
}

测试插入逻辑 #

// 插入surname为空字符串的Person
personRepository.save(new Person("Alice", ""));
// 插入surname为null的Person
personRepository.save(new Person("Bob", null));
// 插入正常字段的Person
personRepository.save(new Person("Charlie", "Brown"));

最终MongoDB中的文档结果 #

• Alice的文档：{ "_id": ObjectId("xxx"), "name": "Alice" }（无surname字段）
• Bob的文档：{ "_id": ObjectId("yyy"), "name": "Bob" }（无surname字段）
• Charlie的文档：{ "_id": ObjectId("zzz"), "name": "Charlie", "surname": "Brown" }

4. 额外注意事项 #

• 如果POJO存在继承关系，当前转换器仅处理当前类的字段，若需处理父类字段，可通过递归遍历source.getClass().getSuperclass()的字段实现
• 若POJO包含嵌套自定义对象，可在转换器中判断字段值类型，递归调用转换逻辑处理嵌套对象
• 若不需要过滤全空格字符串，可将判断条件改为((String) value).isEmpty()

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