Go中JSON序列化可能因不支持的类型、不可导出字段、循环引用等出错，需始终检查json.Marshal返回的错误；通过预处理数据、实现自定义MarshalJSON方法及编写覆盖边界情况的单元测试，可有效提升程序健壮性。
在Go语言开发中，JSON序列化是与Web服务、配置解析和数据存储交互的常见操作。虽然encoding/json包使用简单，但一旦遇到无法正确编码的数据结构，就会返回错误。如何优雅地处理这些错误，是保证程序健壮性的关键。
理解JSON序列化可能出错的原因
Go中的json.Marshal函数在遇到以下情况时会返回错误：
-
包含不支持的类型：如
func、chan、map[complex64]string等无法被JSON表示的类型 - 结构体字段不可导出：小写字母开头的字段不会被序列化，但如果指针为nil还试图访问，可能导致意外行为（虽不直接报错，但容易误判）
-
循环引用：比如结构体中包含指向自身的指针，会导致无限递归，
Marshal会检测并返回错误 - 无效的UTF-8字符串：某些字节序列无法转换为合法JSON字符串
例如：
// 错误示例：包含函数字段 type BadStruct struct { Name string Do func() // 不可序列化 } data, err := json.Marshal(BadStruct{Name: "test"}) // err != nil，提示：json: unsupported type: func()始终检查并处理序列化错误
不要假设json.Marshal一定成功。即使数据看起来“正常”，也应检查返回的错误。
立即学习“go语言免费学习笔记（深入）”；
正确做法：
user := map[string]interface{}{ "name": "Alice", "age": 30, } if data, err := json.Marshal(user); err != nil { log.Printf("JSON序列化失败: %v", err) // 返回HTTP 500或使用默认值 } else { w.Write(data) }在API响应中，若序列化失败，不应返回空或乱码，而应记录日志并返回合理错误响应。
预处理数据避免常见错误
提前清理或验证数据结构，能大幅降低运行时错误概率。
- 避免嵌套过深或不确定结构：如果要序列化的数据来自用户输入或第三方库，先做类型断言或转换
-
使用自定义
MarshalJSON：为复杂类型实现该方法，控制输出格式并捕获内部错误
例如，为包含time.Time的结构体添加序列化逻辑：
type Event struct { ID int `json:"id"` When time.Time `json:"when"` } // 可选：自定义时间格式 func (e Event) MarshalJSON() ([]byte, error) { type Alias Event return json.Marshal(&struct { When string `json:"when"` *Alias }{ When: e.When.Format("2006-01-02 15:04:05"), Alias: (*Alias)(&e), }) }这样即使时间格式特殊，也能可控地转换，而不是让Marshal直接失败。
测试边界情况
编写单元测试覆盖可能出错的场景：
- nil指针结构体
- 含有nil slice或map的字段
- 含不支持类型的匿名字段
- 大数据量或深层嵌套结构
示例测试：
func TestInvalidJSON(t *testing.T) { v := struct { F func() }{} _, err := json.Marshal(v) if err == nil { t.Fatal("期望序列化失败，但未报错") } }通过测试提前发现问题，比线上崩溃更安全。
基本上就这些。Go的JSON序列化错误不可忽视，但只要保持“始终检查err”的习惯，并对复杂类型做好封装，就能写出稳定可靠的服务。不复杂但容易忽略。
