JSON Marshal 库

Hertz 默认集成并使用 Sonic 用于序列化 ctx.JSON 接口，以及反序列化 binding 包中的请求。Sonic 是一款超高性能 golang json 库，详情参考 Sonic README 。

开启 Sonic 需要满足以下条件：

• Go 1.16 以上
• Linux / darwin OS / Windows
• Amd64 CPU with AVX instruction set

当上述条件不能满足时，Sonic 会自动 fallback 到 golang 的 encoding/json 库。

自定义 JSON Marshall 库

如果 Sonic 不能够满足您的需求，你可以使用以下方式自定义 json marshal 库的实现:

import (
    "encoding/json"

    "github.com/bytedance/go-tagexpr/v2/binding"
    "github.com/cloudwego/hertz/pkg/app/server/render"
)
func main() {
    // Render
    render.ResetJSONMarshal(json.Marshal)

    // Binding
    binding.ResetJSONUnmarshaler(json.Unmarshal)
}

条件编译

Hertz 支持条件编译来控制实际使用的 json 库，你可以通过 -tags stdjson 来选择使用标准库。

go build -tags stdjson 

Sonic 相关问题

若出现与 Sonic 相关的问题，可参考 Sonic README 或提 issue 解决。