当数据库无数据时，go 后端需确保 json 响应中指定字段（如 messages）始终为 [] 而非 null；关键在于显式初始化切片，避免零值导致的 nil 序列化。
当数据库无数据时，go 后端需确保 json 响应中指定字段（如 messages）始终为 [] 而非 null；关键在于显式初始化切片，避免零值导致的 nil 序列化。
在 Go 中，结构体字段若声明为切片类型（如 []*Message），其零值为 nil。使用 json.Marshal 序列化 nil 切片时，默认输出为 null，而非空数组 []。这与前端期望的 JSON Schema 不符——前端依赖固定键名（如 messages）始终存在且为数组类型，以便安全遍历或渲染。
要强制返回空数组，必须在序列化前显式初始化切片，而非依赖其零值。以下是两种推荐写法：
✅ 方式一：显式初始化字段（推荐，清晰可读）
func fetchMessages(w http.ResponseWriter, req *http.Request) {
var ib Inbox
ib.Messages = make([]*Message, 0) // 关键：初始化为空切片，容量为 0
err := db.View(func(tx *bolt.Tx) error {
c := tx.Bucket([]byte("messages")).Cursor()
for k, v := c.Last(); k != nil && len(ib.Messages) < 10; 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)
}
return nil
})
if err != nil {
http.Error(w, err.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
}
}✅ 方式二：结构体字面量初始化（简洁，适合单次构造）
ib := Inbox{
Messages: make([]*Message, 0, 10), // 预设容量 10，提升多次 append 性能
}⚠️ 注意事项
- 避免 var ib Inbox 后直接使用未初始化的 ib.Messages：这是导致 null 输出的根本原因；Go 不会自动将 nil 切片转为空数组。
- 优先使用 json.NewEncoder(w).Encode() 替代 json.Marshal() + w.Write()：前者更安全（自动处理错误、避免中间字节切片）、内存更高效。
- 务必检查 db.View 的返回错误：原代码忽略 err，可能导致空响应或 panic；应在 if err != nil 分支中返回恰当 HTTP 错误。
- 若需兼容更多边界场景（如结构体嵌套、自定义 JSON 行为），可实现 json.Marshaler 接口，但对本例而言，显式初始化已足够简洁可靠。
通过这一微小但关键的初始化操作，即可严格保证 API 契约：无论数据库是否含数据，messages 字段始终为有效 JSON 数组，前端可无条件执行 response.messages.forEach(...) 而无需空值校验。
