当数据库无数据时，go 后端需保证 json 响应中指定字段（如 messages）始终为 [] 而非 null，关键在于显式初始化结构体切片字段为空切片。
当数据库无数据时，go 后端需保证 json 响应中指定字段（如 messages）始终为 [] 而非 null，关键在于显式初始化结构体切片字段为空切片。
在 Go 的 JSON 序列化中，未初始化的切片字段（nil）默认被编码为 null，而前端（尤其是强类型前端框架如 TypeScript + Axios 或 React + SWR）通常期望该字段始终为数组类型——即使为空。若后端返回 "messages": null，极易引发前端解构错误、类型校验失败或渲染异常。
问题代码中，Inbox 结构体声明了 Messages []*Message 字段，但未初始化：
var ib Inbox // → ib.Messages == nil
这导致 json.Marshal 将其序列化为 "messages": null。
✅ 正确做法是显式初始化切片为长度为 0 的空切片，而非依赖零值：
ib := Inbox{
Messages: make([]*Message, 0), // 推荐：语义清晰，零分配
}
// 或等价写法
var ib Inbox
ib.Messages = make([]*Message, 0)⚠️ 注意事项：
- make([]*Message, 0) 创建的是长度为 0、底层数组可能为 nil 的空切片，JSON 编码器会将其输出为 []；
- 避免使用 make([]*Message, 0, 10) 作为默认初始化（除非确定高频小数据量），因为预分配容量对空响应无意义，且可能误导维护者；
- 切勿用 []*Message{} 初始化结构体字面量——语法合法但可读性略逊于 make；
- 若后续需追加元素，空切片可直接 append，Go 会自动扩容，无需额外判断。
完整修复后的处理函数关键片段如下：
func fetchMessages(w http.ResponseWriter, req *http.Request) {
// ✅ 显式初始化：确保 Messages 永远不是 nil
ib := Inbox{
Messages: make([]*Message, 0),
}
err := db.View(func(tx *bolt.Tx) error {
c := tx.Bucket([]byte("messages")).Cursor()
for k, v := c.Last(); k != nil; k, v = c.Prev() {
var objmap map[string]*json.RawMessage
if err := json.Unmarshal(v, &objmap); err != nil {
return err
}
message := &Message{}
if err := json.Unmarshal(*objmap["message"], message); err != nil {
return err
}
ib.Messages = append(ib.Messages, message)
if len(ib.Messages) >= 10 { // 提前退出，避免遍历全部
break
}
}
return nil
})
if err != nil {
http.Error(w, "DB error", http.StatusInternalServerError)
return
}
w.Header().Set("Content-Type", "application/json")
w.WriteHeader(http.StatusOK)
if err := json.NewEncoder(w).Encode(ib); err != nil {
http.Error(w, "JSON encode error", http.StatusInternalServerError)
return
}
}? 总结：Go 中“零值安全”不等于“JSON 兼容安全”。对需稳定输出数组的 API 字段，务必在结构体实例化时显式初始化切片——这是保障前后端契约一致的最小成本实践。
