[系列] Go - json.Unmarshal 遇到的小坑

1.問題現象描述

使用 json.Unmarshal()，反序列化時，出現了科學計數法，參考代碼如下：

jsonStr := `{"number":1234567}`
result := make(map[string]interface{})
err := json.Unmarshal([]byte(jsonStr), &result)
if err != nil {
	fmt.Println(err)
}
fmt.Println(result)

// 輸出
// map[number:1.234567e+06]

這個問題不是必現，只有當數字的位數大於 6 位時，才會變成了科學計數法。

2.問題影響描述

當數據結構未知，使用 map[string]interface{} 來接收反序列化結果時，如果數字的位數大於 6 位，都會變成科學計數法，用到的地方都會受到影響。

3.引起問題的原因

從 encoding/json 可以找到答案，看一下這段注釋：

// To unmarshal JSON into an interface value,
// Unmarshal stores one of these in the interface value:
//
//	bool, for JSON booleans
//	float64, for JSON numbers
//	string, for JSON strings
//	[]interface{}, for JSON arrays
//	map[string]interface{}, for JSON objects
//	nil for JSON null

是因為當 JSON 中存在一個比較大的數字時，它會被解析成 float64 類型，就有可能會出現科學計數法的形式。

4.問題的解決方案

方案一

強制類型轉換，參考代碼如下：

jsonStr := `{"number":1234567}`
result := make(map[string]interface{})
err := json.Unmarshal([]byte(jsonStr), &result)
if err != nil {
	fmt.Println(err)
}
fmt.Println(int(result["number"].(float64)))

// 輸出
// 1234567

方案二

盡量避免使用 interface，對 json 字符串結構定義結構體，快捷方法可使用在線工具：https://mholt.github.io/json-to-go/。

type Num struct {
	Number int `json:"number"`
}

jsonStr := `{"number":1234567}`
var result Num
err := json.Unmarshal([]byte(jsonStr), &result)
if err != nil {
	fmt.Println(err)
}
fmt.Println(result)

// 輸出
// {1234567}

方案三

使用 UseNumber() 方法。

jsonStr := `{"number":1234567}`
result := make(map[string]interface{})
d := json.NewDecoder(bytes.NewReader([]byte(jsonStr)))
d.UseNumber()
err := d.Decode(&result)
if err != nil {
	fmt.Println(err)
}
fmt.Println(result)

// 輸出
// map[number:1234567]

這時一定要注意 result["number"] 的數據類型！

fmt.Println(fmt.Sprintf("type: %v", reflect.TypeOf(result["number"])))

// 輸出
// type: json.Number

通過代碼可以看出 json.Number 其實就是字符串類型：

// A Number represents a JSON number literal.
type Number string

如果轉換其他類型，參考如下代碼：

// 轉成 int64
numInt, _ := result["number"].(json.Number).Int64()
fmt.Println(fmt.Sprintf("value: %v, type: %v", numInt, reflect.TypeOf(numInt)))

// 輸出
// value: 1234567, type: int64

// 轉成 string
numStr := result["number"].(json.Number).String()
fmt.Println(fmt.Sprintf("value: %v, type: %v", numStr, reflect.TypeOf(numStr)))

// 輸出
// value: 1234567, type: string