MongoTemplate更新查询中POJO转Bson的字段排序是否具备确定性

核心结论 #

默认配置下，MongoTemplate不会保证稳定的字段序列化顺序，你观察到的MappingMongoConverter源码逻辑确实是导致该问题的核心原因。

原因说明 #

• 你贴出的writeProperties方法中，遍历MongoPersistentEntity属性的迭代逻辑，默认基于Java反射获取类字段的返回顺序。而Java官方的Class.getDeclaredFields()方法明确不保证返回字段的顺序固定，不同JDK版本、不同运行环境都可能出现顺序差异。
• 即使在同一运行环境下，如果POJO类后续做了字段增减、注解调整等改动，也会改变MongoPersistentEntity的属性迭代顺序，最终生成字段顺序不同的Bson文档。这种情况下即使POJO字段值完全相同，也会被MongoDB的$addToSet判定为不同元素，导致重复插入数组。

解决方案 #

如果要依赖$addToSet实现数组元素精确去重，必须主动固定序列化顺序，可选择以下两种方案：

1. 字段级别指定顺序（推荐）：给POJO类的所有字段添加@Field(order = 优先级数字)注解，Spring Data MongoDB会按照order值从小到大排序后序列化，严格保证字段顺序固定。示例代码如下：

import org.springframework.data.mongodb.core.mapping.Field;

public class ArrayElement {
    @Field(order = 1)
    private String type;
    @Field(order = 2)
    private String content;
    @Field(order = 3)
    private Long timestamp;
    
    // 省略getter、setter方法
}

2. 全局配置排序规则：自定义MongoMappingContext的属性比较器，强制所有POJO按照字段名字母顺序排序序列化，无需逐个字段加注解，适合POJO数量较多的场景。

验证方法 #

你可以通过以下代码手动验证序列化顺序是否符合预期：

// 替换为你自己的POJO实例
ArrayElement element = new ArrayElement("test", "测试内容", 1690000000000L);
Document document = new Document();
mongoTemplate.getConverter().write(element, document);
// 打印输出Document，检查字段顺序是否固定
System.out.println(document);

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