Jackson ObjectMapper序列化JsonNode时如何使其遵循配置的序列化特性？

你遇到的问题是：配置SORT_PROPERTIES_ALPHABETICALLY和ORDER_MAP_ENTRIES_BY_KEYS后，Map序列化会按字母排序，但JsonNode（具体是ObjectNode）仍保留插入顺序。这是因为Jackson对ObjectNode的序列化逻辑独立于普通Map/POJO的处理路径——默认ObjectNode用LinkedHashMap存储字段，直接按插入顺序输出，不会触发配置的排序规则。

解决方案：自定义ObjectNode序列化器 #

通过给ObjectNode注册一个自定义序列化器，强制序列化时按键排序，就能让它遵循你想要的排序规则。

1. 实现自定义序列化器

import com.fasterxml.jackson.core.JsonGenerator;
import com.fasterxml.jackson.databind.SerializerProvider;
import com.fasterxml.jackson.databind.node.ObjectNode;
import com.fasterxml.jackson.databind.ser.std.ObjectNodeSerializer;

import java.io.IOException;
import java.util.ArrayList;
import java.util.List;
import java.util.Map;

public class SortedObjectNodeSerializer extends ObjectNodeSerializer {
    @Override
    protected void serializeFields(ObjectNode node, JsonGenerator gen, SerializerProvider provider) throws IOException {
        // 提取所有字段并按key排序
        List<Map.Entry<String, JsonNode>> sortedEntries = new ArrayList<>(node.fields());
        sortedEntries.sort(Map.Entry.comparingByKey());
        
        // 按排序后的顺序输出字段
        for (Map.Entry<String, JsonNode> entry : sortedEntries) {
            gen.writeFieldName(entry.getKey());
            provider.defaultSerializeValue(entry.getValue(), gen);
        }
    }
}

2. 注册序列化器到ObjectMapper

修改你的初始化代码，把自定义序列化器注册到ObjectMapper中：

import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.databind.module.SimpleModule;
import com.fasterxml.jackson.databind.node.ObjectNode;
import com.fasterxml.jackson.databind.MapperFeature;
import com.fasterxml.jackson.databind.SerializationFeature;
import com.google.common.collect.ImmutableMap;

public class JsonNodeSortExample {
    public static void main(String[] args) throws Exception {
        ObjectMapper mapper = new ObjectMapper()
                .configure(MapperFeature.SORT_PROPERTIES_ALPHABETICALLY, true)
                .configure(SerializationFeature.ORDER_MAP_ENTRIES_BY_KEYS, true);

        // 注册自定义序列化器
        SimpleModule sortedModule = new SimpleModule();
        sortedModule.addSerializer(ObjectNode.class, new SortedObjectNodeSerializer());
        mapper.registerModule(sortedModule);

        // 测试Map序列化
        Map<String, Object> map = ImmutableMap.of(
                "c", "3",
                "b", "2",
                "a", "1");
        System.out.println("1) " + mapper.writeValueAsString(map));

        // 测试JsonNode序列化
        ObjectNode jsonNode = mapper.createObjectNode()
                .put("c", "3")
                .put("b", "2")
                .put("a", "1");
        System.out.println("2) " + mapper.writeValueAsString(jsonNode));
    }
}

输出结果

1) {"a":"1","b":"2","c":"3"}
2) {"a":"1","b":"2","c":"3"}

其他可选方案 #

如果你不想自定义序列化器，也可以在序列化JsonNode前，先把它转换为SortedMap再序列化：

SortedMap<String, Object> sortedMap = mapper.convertValue(jsonNode, new TypeReference<SortedMap<String, Object>>() {});
System.out.println("2) " + mapper.writeValueAsString(sortedMap));

这种方法虽然简单，但会额外产生一个Map对象，对于复杂的JsonNode结构，性能和内存开销会略高。

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