如何在 Golang 中编写一个 JSON 数据校验工具_Golang 结构体验证项目实战-Golang-PHP中文网

答案：本文介绍如何在Golang中通过结构体标签实现JSON数据校验，定义如required、min、max、email等规则，并利用反射解析标签进行字段验证，结合ValidationError返回错误信息，在Gin框架中集成校验逻辑，支持请求参数合法性检查，同时提出扩展建议如嵌套校验、性能优化及多语言支持，强调手动实现有助于理解原理并为定制化需求提供基础。

如何在 golang 中编写一个 json 数据校验工具_golang 结构体验证项目实战

在 Golang 开发中，处理 JSON 请求数据时，校验数据的完整性和合法性是保证服务稳定的关键环节。直接使用 json.Unmarshal 只能完成反序列化，无法判断字段是否符合业务要求。因此，编写一个结构清晰、可复用的 JSON 数据校验工具非常必要。本文带你从零实现一个基于结构体标签的 JSON 校验器，适用于 Web 项目中的请求参数验证。

定义校验规则与结构体标签

Go 结构体支持通过标签（tag）附加元信息，我们可以利用 validate 标签定义字段的校验规则。例如：

type LoginRequest struct {
    Username string `json:"username" validate:"required,min=3,max=20"`
    Password string `json:"password" validate:"required,min=6"`
    Email    string `json:"email"    validate:"omitempty,email"`
}

上面的 validate 标签含义如下：

Red Panda AI

AI文本生成图像

下载

required：字段必须存在且非空
min=3：字符串最小长度为 3
max=20：最大长度为 20
omitempty：允许字段为空，但如果存在则需满足后续规则
email：必须符合邮箱格式

实现基础校验逻辑

我们创建一个 Validate 函数，接收任意结构体指针，解析其字段的 validate 标签并执行校验。

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

package validator

import (
    "reflect"
    "regexp"
    "strings"
)

type ValidationError struct {
    Field   string
    Message string
}

func Validate(v interface{}) []ValidationError {
    var errors []ValidationError

    rv := reflect.ValueOf(v)
    if rv.Kind() == reflect.Ptr {
        rv = rv.Elem()
    }

    rt := rv.Type()

    for i := 0; i < rv.NumField(); i++ {
        field := rv.Field(i)
        structField := rt.Field(i)
        tag := structField.Tag.Get("validate")

        if tag == "" || tag == "-" {
            continue
        }

        if err := validateField(field, structField.Name, tag); err != nil {
            errors = append(errors, *err)
        }
    }

    return errors
}