Go语言结构体JSON序列化返回空对象{}的根源与完整解决方案-Golang-PHP中文网

Go语言结构体JSON序列化返回空对象{}的根源与完整解决方案

go中json.marshal返回空json（如{}）却无错误，根本原因是结构体字段未导出（首字母小写），导致encoding/json包通过反射无法访问字段——这是最常见也最易被忽略的可见性陷阱。

go中json.marshal返回空json（如{}）却无错误，根本原因是结构体字段未导出（首字母小写），导致encoding/json包通过反射无法访问字段——这是最常见也最易被忽略的可见性陷阱。

在Go语言中，encoding/json 包依赖 reflect 包实现序列化，而 Go 的反射机制严格遵循包级可见性规则：只有首字母大写的导出字段（exported field）才能被外部包（包括 encoding/json）读取和序列化；所有小写字母开头的字段（如 isbn、title）均属非导出字段，会被静默忽略——既不报错，也不输出任何键值，最终导致 json.Marshal 返回空对象 {} 或空数组 []，极易误导开发者误判为“数据为空”或“逻辑错误”。

✅ 正确写法：确保所有待序列化字段导出

以提问中的 Book 结构体为例，原始定义存在典型问题：

type Book struct {
    isbn   string  // ❌ 非导出字段 → 被json包完全忽略
    title  string
    author string
    price  float32
}

应改为：

type Book struct {
    Isbn   string  `json:"isbn"`   // ✅ 导出字段 + 显式JSON键名
    Title  string  `json:"title"`
    Author string  `json:"author"`
    Price  float32 `json:"price"`
}

同时，数据库扫描逻辑也需同步更新：

Comprehensive Three.js 3D graphics reference

详细的 Three.js 3D 图形参考，涵盖场景设置、相机、几何体、材质、光照、动画、控制器、加载器、数学工具和调试。

下载

bk := new(Book)
err := rows.Scan(&bk.Isbn, &bk.Title, &bk.Author, &bk.Price) // ✅ 字段名匹配导出名
if err != nil {
    log.Fatal(err)
}

? 提示：json 标签非必需，但强烈推荐显式声明。若省略（如 Isbn string），默认 JSON 键名为 Isbn（驼峰转蛇形需额外配置）；添加 json:"isbn" 可精确控制输出键名，提升API一致性。

⚠️ 常见陷阱与进阶注意事项

嵌套结构体逐层导出：若 Book 中嵌入另一个结构体（如 type Metadata struct { CreatedAt time.Time }），则 CreatedAt 也必须大写（CreatedAt），否则整个嵌入字段失效。
指针与 nil 处理：若字段为指针（如 Author *string）且值为 nil，序列化后对应 JSON 值为 null，而非跳过；如需跳过空值，使用 json:",omitempty" 标签。
不可序列化类型：func、chan、含循环引用的指针、map 的非字符串键（如 map[struct{}]int）等均会触发 json.UnsupportedTypeError。time.Time 需配合 json:"-" + 自定义 MarshalJSON() 方法处理格式（如 RFC3339）。

错误处理不可省略：虽然字段未导出不会报错，但其他问题（如循环引用）会导致 panic。务必检查 err：

data, err := json.Marshal(books)
if err != nil {
    http.Error(w, "JSON encode error: "+err.Error(), http.StatusInternalServerError)
    return
}
w.Header().Set("Content-Type", "application/json")
w.Write(data)

? 验证示例

修正后的完整 main.go 片段（关键部分）：

type Book struct {
    Isbn   string  `json:"isbn"`
    Title  string  `json:"title"`
    Author string  `json:"author"`
    Price  float32 `json:"price"`
}

// ... 数据库查询逻辑 ...
var bks []Book
for rows.Next() {
    var isbn, title, author string
    var price float32
    if err := rows.Scan(&isbn, &title, &author, &price); err != nil {
        log.Fatal(err)
    }
    bks = append(bks, Book{Isbn: isbn, Title: title, Author: author, Price: price})
}

http.HandleFunc("/db", func(w http.ResponseWriter, r *http.Request) {
    data, err := json.Marshal(bks)
    if err != nil {
        http.Error(w, err.Error(), http.StatusInternalServerError)
        return
    }
    w.Header().Set("Content-Type", "application/json")
    w.Write(data) // 输出: [{"isbn":"978-1503261969","title":"Emma","author":"Jane Austen","price":9.44},...]
})

✅ 总结

问题现象	根本原因	解决方案
json.Marshal 返回 {} 或 []，err == nil	结构体字段未导出（小写首字母）	所有需序列化的字段首字母大写
JSON 键名与期望不符	缺少 json 标签或标签拼写错误	使用 json:"key_name" 显式声明
出现 unsupported type 错误	传入 func/chan/循环引用/非法 map 键	检查值类型，移除或封装不可序列化字段