Go : json.Unmarshal 什么时候会返回 struct 错误？

Question

假设我有一个像

type A struct{

  name string`json:"name"`

}

然后在主要我有代码

var jsonString string = `{"status":false}`

var a A

error := json.Unmarshal([]byte(jsonString),&a)

显然上面的代码会产生一个 nil 错误，不管 json 格式是不同的。json.Unmarshal() 什么时候会在 Go 中返回错误？

Answer 1

如果源中的值与目标中的值不对应，JSON 解码器不会报告错误。例如，如果源包含字段“状态”，但目标不包含，这不是错误。Unmarshal 函数在其他情况下确实会返回错误。语法错误type A struct {    Name string `json:"name"`}data = []byte(`{"name":what?}`)err = json.Unmarshal(data, &a)fmt.Println(err)  // prints character 'w' looking for beginning of value目标类型无法表示的 JSON 值：data := []byte(`{"name":false}`)type B struct {  Name string `json:"name"`}var b Berr = json.Unmarshal(data, &b)fmt.Println(err) // prints cannot unmarshal bool into Go value of type string（这是一个不能用目标类型表示值的例子。还有更多。）

Answer 2

还有更多json.Unmarshal()返回错误的示例（除了指定无效的 JSON）：指定一个nil或empty切片：i := 0err := json.Unmarshal(nil, &i)fmt.Println(err) // unexpected end of JSON input指定一个非指针解组为：err = json.Unmarshal([]byte(`{"name":"a"}`), i)fmt.Println(err) // json: Unmarshal(non-pointer int)指定nil为目标指针：err = json.Unmarshal([]byte(`{"name":"a"}`), nil)fmt.Println(err) // json: Unmarshal(nil)指定会溢出目标类型的 JSON 数字。引用文档json.Unmarshal()：如果 JSON 值不适合给定的目标类型，或者 JSON 数字溢出目标类型，则 Unmarshal 会跳过该字段并尽可能完成解组。如果没有遇到更严重的错误，Unmarshal 将返回描述最早的此类错误的 UnmarshalTypeError。为了证明这一点：var j int8err = json.Unmarshal([]byte(`1112`), &j)fmt.Println(err) // json: cannot unmarshal number 1112 into Go value of type int8或者当尝试将某些内容解析time.Time为不是 RFC3339 时间戳的 a 时：var t time.Timeerr = json.Unmarshal([]byte(`"xx"`), &t)fmt.Println(err) // parsing time ""xx"" as ""2006-01-02T15:04:05Z07:00"": cannot parse "xx"" as "2006"

Answer 3

要添加到 icza 的答案中，如果您尝试将 Unmarshal 解组为类型化的 nil 指针，您也可能会收到错误消息。例如，如果您创建一个指向特定类型的指针切片，然后尝试解组为这些指针中的特定一个，则可能会发生这种情况。package mainimport (    "fmt"    "encoding/json")type Example struct {Name string}func main() {        exs := make([]*Example, 5)        err := json.Unmarshal([]byte(`{"name":"jane"}`), exs[0])        fmt.Println(err)}// json: Unmarshal(nil *main.Example)