GolangJSON校验工具开发教程

本文深入浅出地展示了如何在Golang中从零手写一个轻量、可扩展的JSON数据校验工具——通过结构体`validate`标签定义`required`、`min`、`max`、`email`等业务规则，借助反射动态解析并执行字段级验证，返回结构化的`ValidationError`，再无缝集成到Gin等Web框架中实现请求参数的即时合法性检查；不仅剖析了核心实现细节（如嵌套处理思路、正则性能优化、错误聚合机制），还务实指出生产环境推荐成熟方案（如go-playground/validator），强调手动造轮子的价值在于透彻理解原理、应对特殊定制需求，并为后续高阶功能（多语言提示、复杂类型校验、性能调优）打下坚实基础。

在 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 标签含义如下：

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

实现基础校验逻辑

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

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