Golang中jsonapi.Marshal返回空结构体处理布尔值false的问题

你遇到的是DataDog jsonapi库的默认行为：该库会忽略结构体中的零值字段。wrappers.BoolValue的Value字段类型是bool，false是它的零值，所以序列化时这个字段被跳过，最终Active字段变成空JSON对象{}。

1. 自定义布尔包装结构体 #

替换wrappers.BoolValue为自定义结构体，确保即使Value为false也能被序列化：

type BoolWrapper struct {
    Value bool `json:"value"`
}

// 修改MyResource的定义
type MyResource struct {
    ID     string        `jsonapi:"primary,my-resource"`
    Active *BoolWrapper `jsonapi:"attribute"`
}

这样序列化时，无论Value是true还是false，都会输出{"value": true/false}。

2. 为wrappers.BoolValue实现自定义JSON:API序列化 #

实现jsonapi.Marshaler接口，手动控制序列化逻辑：

import "encoding/json"

func (b *wrappers.BoolValue) MarshalJSONAPI() ([]byte, error) {
    return json.Marshal(map[string]bool{"value": b.Value})
}

注册这个方法后，jsonapi库会优先调用自定义的序列化逻辑，确保false值被正确输出。

不建议让调用方默认将空JSON对象解析为false——空对象在语义上更接近“未设置”而非明确的false，这种约定会增加API的歧义性，容易引发逻辑错误。优先修复服务端的序列化输出，保证API返回明确的布尔值。

内容的提问来源于stack exchange，提问作者BeeGee