如何使用Golang测试JSON序列化-Golang-PHP中文网

如何使用Golang测试JSON序列化

P粉602998670

发布： 2025-10-07 16:21:02

原创

160人浏览过

答案：文章介绍了在Go项目中如何使用testing包和encoding/json对结构体进行JSON序列化与反序列化测试。首先定义带有json tag的User结构体，然后编写TestUser_MarshalJSON测试正常序列化、TestUser_MarshalJSON_OmitEmpty验证omitempty行为、TestUser_UnmarshalJSON测试反序列化正确性，并可通过testify库简化字段比较，确保API数据交互的可靠性。

如何使用golang测试json序列化

测试 JSON 序列化在 Go 项目中很常见，尤其是在构建 API 或处理数据传输时。你需要确保结构体能正确地编码为 JSON 字符串，也能从 JSON 正确解码回来。下面介绍如何用 Golang 的 testing 包和 encoding/json 来完成这类测试。

定义待序列化的结构体

假设你有一个表示用户信息的结构体：

<pre class="brush:php;toolbar:false;">type User struct {
    ID   int    `json:"id"`
    Name string `json:"name"`
    Email string `json:"email,omitempty"`
}

登录后复制

字段上的 json tag 控制了序列化后的键名，omitempty 表示当字段为空时不会出现在 JSON 输出中。

编写测试函数验证序列化

在 user_test.go 中写一个测试，检查结构体能否正确转成预期的 JSON。

立即学习“go语言免费学习笔记（深入）”；

<pre class="brush:php;toolbar:false;">func TestUser_MarshalJSON(t *testing.T) {
    user := User{
        ID:    1,
        Name:  "Alice",
        Email: "alice@example.com",
    }

    data, err := json.Marshal(user)
    if err != nil {
        t.Fatalf("marshal failed: %v", err)
    }

    expected := `{"id":1,"name":"Alice","email":"alice@example.com"}`
    if string(data) != expected {
        t.Errorf("expected %s, got %s", expected, string(data))
    }
}

登录后复制

这个测试验证了：

json.Marshal 能成功执行
输出的 JSON 字符串与预期一致

测试空字段的 omitempty 行为

你可以再写一个测试，验证当 Email 为空时，它是否被省略。

Softr Studio

最简单的无代码web开发平台

查看详情

<pre class="brush:php;toolbar:false;">func TestUser_MarshalJSON_OmitEmpty(t *testing.T) {
    user := User{
        ID:   2,
        Name: "Bob",
        // Email 留空
    }

    data, err := json.Marshal(user)
    if err != nil {
        t.Fatalf("marshal failed: %v", err)
    }

    expected := `{"id":2,"name":"Bob"}`
    if string(data) != expected {
        t.Errorf("expected %s, got %s", expected, string(data))
    }
}

登录后复制

测试反序列化（Unmarshal）

除了序列化，你也应测试从 JSON 还原结构体是否正确。

<pre class="brush:php;toolbar:false;">func TestUser_UnmarshalJSON(t *testing.T) {
    input := `{"id":3,"name":"Charlie","email":"charlie@example.com"}`

    var user User
    err := json.Unmarshal([]byte(input), &user)
    if err != nil {
        t.Fatalf("unmarshal failed: %v", err)
    }

    if user.ID != 3 {
        t.Errorf("expected ID 3, got %d", user.ID)
    }
    if user.Name != "Charlie" {
        t.Errorf("expected Name Charlie, got %s", user.Name)
    }
    if user.Email != "charlie@example.com" {
        t.Errorf("expected Email charlie..., got %s", user.Email)
    }
}

登录后复制

这种测试确保你的结构体能正确解析外部输入的 JSON 数据。

使用反射或 testify 提高测试可读性

如果字段较多，手动比较每个字段会很繁琐。可以使用 reflect.DeepEqual 或第三方库如 testify/assert 简化断言。

<pre class="brush:php;toolbar:false;">import "github.com/stretchr/testify/assert"

func TestUser_UnmarshalJSON_WithTestify(t *testing.T) {
    input := `{"id":4,"name":"Dana"}`
    var user User
    json.Unmarshal([]byte(input), &user)

    expected := User{ID: 4, Name: "Dana"}
    assert.Equal(t, expected, user)
}

登录后复制

这样代码更简洁，也更容易维护。

基本上就这些。只要覆盖典型场景：正常序列化、空字段处理、反序列化还原，就能保证你的结构体在 JSON 交互中表现可靠。

以上就是如何使用Golang测试JSON序列化的详细内容，更多请关注php中文网其它相关文章！