Golang中有序Map序列化JSON时的键顺序异常问题

问题根源 #

你遇到的顺序不稳定问题，本质是标准库encoding/json反序列化到普通map[string]any时会丢失字段顺序，后续再转OrderedMap也没法恢复原始顺序。必须从JSON解析的第一步就保留字段顺序。

具体实现步骤 #

1. 使用支持有序解析的JSON库
   用github.com/goccy/go-json，它原生支持解析到OrderedMap，能完整保留JSON的原始字段顺序，且不需要定义结构体，适合处理复杂多变的JSON结构。

2. 递归处理单元素数组转Map
   写一个递归函数遍历整个有序Map结构，识别出长度为1的数组，将其替换为数组内的单个元素；嵌套的结构也需要递归处理。

3. 序列化时保持顺序
   用同一个库的序列化方法，直接将处理后的OrderedMap序列化为JSON，保证输出顺序和原始一致。

完整代码示例 #

package main

import (
	"fmt"
	"log"

	"github.com/goccy/go-json"
)

func processSingleElementArray(v any) any {
	switch val := v.(type) {
	case *json.OrderedMap:
		// 遍历OrderedMap的所有键值对（按原始顺序）
		newMap := json.NewOrderedMap()
		keys := val.Keys()
		for _, key := range keys {
			val, _ := val.Get(key)
			newVal := processSingleElementArray(val)
			newMap.Set(key, newVal)
		}
		return newMap
	case []any:
		// 处理单元素数组
		if len(val) == 1 {
			return processSingleElementArray(val[0])
		}
		// 多元素数组递归处理每个元素
		newArr := make([]any, len(val))
		for i, item := range val {
			newArr[i] = processSingleElementArray(item)
		}
		return newArr
	default:
		// 基础类型直接返回
		return val
	}
}

func main() {
	// 模拟原始JSON输入
	rawJSON := `{
		"field1": "value1",
		"field2": [{"nestedKey": "nestedValue"}],
		"field3": ["singleValue"],
		"field4": {
			"subField1": [1],
			"subField2": [2, 3]
		}
	}`

	// 解析为OrderedMap（保留原始顺序）
	var orderedMap *json.OrderedMap
	if err := json.Unmarshal([]byte(rawJSON), &orderedMap); err != nil {
		log.Fatal(err)
	}

	// 处理单元素数组
	processed := processSingleElementArray(orderedMap)

	// 序列化输出（保持顺序）
	resultJSON, err := json.MarshalIndent(processed, "", "  ")
	if err != nil {
		log.Fatal(err)
	}

	fmt.Println(string(resultJSON))
}

关键说明 #

• 全程使用go-json的OrderedMap，从解析到序列化都保证顺序，避免了标准库的无序问题。
• 递归函数能处理任意嵌套深度的JSON结构，包括嵌套数组、嵌套Map，适配复杂多变的JSON场景。
• 不需要定义结构体，完全动态处理JSON结构，符合你的需求。

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