Go语言中如何反序列化键为非内置类型的JSON Map？

你遇到的问题核心有两点：一是自定义类型作为Go map的key时，JSON反序列化依赖的是encoding.TextUnmarshaler接口，而非你现在实现的json.Unmarshaler；二是你原本的UnmarshalJSON方法没有处理JSON字符串的引号问题，即使接口用对了也会匹配失败。

为什么会报错？ #

JSON的键本质上都是字符串，比如你JSON里的"TIER1"是带双引号的。当尝试反序列化为map[Tier]string时，encoding/json包不会把键当作完整的JSON值来解析（也就不会触发UnmarshalJSON），而是会提取键的纯字符串内容，尝试用文本解析的方式转成你的自定义类型。由于你没有实现TextUnmarshaler，包会尝试默认解析逻辑——把字符串当作数字处理，自然就会报错说“无法将TIER1解析为main.Tier类型”。

修正方案 #

我们需要把UnmarshalJSON替换为encoding.TextUnmarshaler接口的UnmarshalText方法，同时如果需要序列化的话，也可以补充实现对称的MarshalText方法：

package main

import (
	"encoding/json"
	"errors"
	"fmt"
)

type Tier int

// 实现encoding.TextUnmarshaler接口，用于解析JSON Map的键
func (t *Tier) UnmarshalText(data []byte) error {
	switch string(data) {
	case "TIER1":
		*t = 1
	case "TIER2":
		*t = 2
	default:
		return errors.New("unrecognized tier value")
	}
	return nil
}

// 可选：实现encoding.TextMarshaler接口，支持将Map序列化为JSON
func (t Tier) MarshalText() ([]byte, error) {
	switch t {
	case 1:
		return []byte("TIER1"), nil
	case 2:
		return []byte("TIER2"), nil
	default:
		return nil, errors.New("unrecognized tier value")
	}
}

func main() {
	jsonData := []byte(`{ "TIER1": "hello", "TIER2": "world" }`)
	unmarshaledData := map[Tier]string{}
	if err := json.Unmarshal(jsonData, &unmarshaledData); err != nil {
		fmt.Println("Error: ", err)
		return
	}
	fmt.Println("Unmarshaled data: ", unmarshaledData)

	// 可选测试序列化功能
	serialized, err := json.Marshal(unmarshaledData)
	if err != nil {
		fmt.Println("Serialize error: ", err)
		return
	}
	fmt.Println("Serialized data: ", string(serialized))
}

关键说明 #

• UnmarshalText接收的是JSON键的纯字符串字节（比如TIER1而非带引号的"TIER1"），所以你的switch逻辑可以直接匹配，无需处理引号。
• 实现MarshalText是为了保证序列化和反序列化的对称性——如果之后需要把这个map再转成JSON，能输出正确的字符串键。
• json.Unmarshaler接口是用来处理JSON值的（比如{"level": "TIER1"}里的TIER1），而不是map的键，所以之前的方法根本不会被调用。

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