首页 > 脚本专栏 > Golang > Golang中json.Marshal避坑

Golang中json.Marshal避坑指南

2026-06-25 08:35:21 作者：好易学·数据结构

Golang库自带的json序列化与反序列化方法详解,结合Marshaler和Unmarshal接口的应用,避免base64编码问题

1、介绍

Golang库自带了json序列化与反序列化方法，

typeMarshaler

type Marshaler interface {
    MarshalJSON() ([]byte, error)
}

实现了Marshaler接口的类型可以将自身序列化为合法的json描述。

typeUnmarshaler

type Unmarshaler interface {
    UnmarshalJSON([]byte) error
}

实现了Unmarshaler接口的对象可以将自身的json描述反序列化。

该方法可以认为输入是合法的json字符串。

如果要在方法返回后保存自身的json数据，必须进行拷贝。

2、问题描述

如果Marshaler使用不当，会存在base64编码问题，示例如下：

package main

import (
	"encoding/json"
	"fmt"
)

type TestData struct {
	Id   int
	Msg  string
	Data interface{}
}

func main() {
	data := TestData{
		Id:   0,
		Msg:  "OK",
		Data: nil,
	}
	m := make(map[string]interface{})
	v, _ := json.Marshal(&data) //v：[]byte类型
	m["result"] = v
	fmt.Println("map[result]的值：", string(v))
	bytes, _ := json.Marshal(&m)
	fmt.Println(string(bytes))
}

现在对 eyJJZCI6MCwiTXNnIjoiT0siLCJEYXRhIjpudWxsfQ== 进行base64解码看看情况：

可以看出，

json.Marshal

对字符串 {"Id":0,"Msg":"OK","Data":null} 进行了编码。

3、解决方法

示例：

package main

import (
	"encoding/json"
	"fmt"
)

type TestData struct {
	Id   int
	Msg  string
	Data interface{}
}

func main() {
	data := TestData{
		Id:   0,
		Msg:  "OK",
		Data: nil,
	}
	m := make(map[string]interface{})
	v, _ := json.Marshal(&data)
	m["result"] = string(v)  // 将[]byte 转string
	fmt.Println("map[result]的值：", string(v))
	bytes, _ := json.Marshal(&m)
	fmt.Println(string(bytes))
}

可以看出，通过将 []byte 类型的 v 转化为string，

json.Marshal

就不会对内容进行base64编码了。

总结

以上为个人经验，希望能给大家一个参考，也希望大家多多支持脚本之家。