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"`
}同时，数据库扫描逻辑也需同步更新：
Json Schema Toolkit
下载
使用 JSON Schema 验证 JSON 数据，从示例 JSON 生成 schema，并将其转换为 TypeScript 接口、Python 数据类或 Markdown 文档。
立即学习“go语言免费学习笔记（深入）”；
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 键 | 检查值类型，移除或封装不可序列化字段 |
牢记一条铁律：Go 的 JSON 序列化不是语法问题，而是可见性问题。只要字段导出、类型合法、无循环引用，json.Marshal 就能稳定工作。
