Go 中 JSON 解码失败的常见原因：结构体字段必须导出-Golang-PHP中文网

Go 中 JSON 解码失败的常见原因：结构体字段必须导出

Go 的 encoding/json 包仅能解码导出（首字母大写）的结构体字段；小写字段默认被忽略，导致解码后为空且无错误提示。

go 的 `encoding/json` 包仅能解码导出（首字母大写）的结构体字段；小写字段默认被忽略，导致解码后为空且无错误提示。

在 Go 中，JSON 反序列化（即 json.Unmarshal）依赖于反射机制，而该机制只能访问导出（exported）字段——也就是首字母大写的字段。未导出字段（如 name string）在反射层面不可见，因此 json 包会静默跳过它们，既不会填充数据，也不会返回错误，这正是你遇到问题的根本原因。

以下是你原始代码的问题分析与修正版本：

使用Go语言搭建家庭相册系统-相关课件

下载

❌ 原始代码（无法工作）

b := []byte(`{"groups":[{"name":"foo"},{"name":"bar"}]}`)
type Group struct{ name string } // ❌ 小写 name：未导出，不可被 json 包访问
var contents struct {
    groups []Group // ❌ 小写 groups：同样未导出
}
err := json.Unmarshal(b, &contents)
fmt.Printf("contents = %+v\nerr = %+v\n", contents, err)
// 输出：contents = {groups:[]}，err = nil → 表面成功，实则失效

✅ 正确写法（关键：首字母大写 + 可选 JSON 标签）

package main

import (
    "encoding/json"
    "fmt"
)

func main() {
    b := []byte(`{"groups":[{"name":"foo"},{"name":"bar"}]}`)

    type Group struct {
        Name string `json:"name"` // ✅ 导出字段；tag 可省略（因字段名匹配），但建议显式声明
    }

    var contents struct {
        Groups []Group `json:"groups"` // ✅ 导出字段，且 tag 明确映射 key
    }

    err := json.Unmarshal(b, &contents)
    if err != nil {
        panic(err)
    }

    fmt.Printf("contents = %+v\n", contents)
    // 输出：contents = {Groups:[{Name:"foo"} {Name:"bar"}]}
}

⚠️ 注意事项

导出性是硬性要求：无论是否使用 json tag，字段名必须大写，否则 Unmarshal 完全忽略该字段。
JSON tag 是可选但推荐的：例如 Name stringjson:"name"可实现大小写映射（Go 字段Name↔ JSON 键"name"`），提升可维护性与兼容性。
零值静默处理：未导出字段解码失败时不会报错，只会保持零值（如 nil、0、""），极易引发隐蔽 Bug——务必通过 err != nil 检查错误，并结合日志或调试验证结构体内容。
嵌套结构同理：所有需参与 JSON 编解码的嵌套结构体字段（包括匿名字段）都必须导出。