简明指南：通过Go语言实现数据校验功能-Golang-PHP中文网

简明指南：通过Go语言实现数据校验功能

尼克

发布： 2025-08-01 08:58:01

原创

358人浏览过

数据校验在go语言中可通过定义规则并使用工具库实现，核心步骤为：1. 定义数据结构与校验规则，使用validator库的标签指定字段约束；2. 创建validator实例并调用struct方法进行校验；3. 处理错误信息，遍历validationerrors获取具体字段和规则冲突；4. 自定义校验规则时注册函数并绑定标签；5. 嵌套结构体校验需添加dive标签；6. 性能优化可依赖缓存或代码生成减少反射开销。

简明指南：通过Go语言实现数据校验功能

数据校验，说白了，就是确保你接收到的数据是靠谱的，符合你的预期。Go 语言在这方面提供了不少工具，用起来也挺顺手。

数据校验的核心在于定义规则，然后应用这些规则去检查数据。Go 语言的标准库 reflect 和 strconv 可以帮你处理类型和转换，而像 go-playground/validator/v10 这样的第三方库则提供了更强大、更灵活的校验能力。

解决方案

定义数据结构和校验规则：

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

首先，定义你的数据结构，并使用 validator 库的标签来定义校验规则。

package main

import (
    "fmt"
    "github.com/go-playground/validator/v10"
)

type User struct {
    FirstName string `validate:"required,min=2,max=30"`
    LastName  string `validate:"required,min=2,max=30"`
    Age       int    `validate:"gte=0,lte=130"`
    Email     string `validate:"required,email"`
}

func main() {
    user := User{
        FirstName: "Jo",
        LastName:  "Bloggs",
        Age:       45,
        Email:     "jbloggs@example.com",
    }

    validate := validator.New()
    err := validate.Struct(user)

    if err != nil {
        fmt.Println(err)
        return
    }

    fmt.Println("Validation successful")
}

登录后复制

这里，FirstName 和 LastName 字段都要求必填，且长度在 2 到 30 个字符之间。Age 必须在 0 到 130 之间。Email 必须是有效的电子邮件地址。

使用 validator 库进行校验：

创建一个 validator 实例，然后使用 Struct 方法来校验你的数据结构。如果校验失败，err 会包含详细的错误信息。

ViiTor实时翻译
AI实时多语言翻译专家！强大的语音识别、AR翻译功能。

116

查看详情
处理校验错误：

校验失败时，err 返回的是一个 ValidationErrors 类型的错误。你可以遍历这个错误，获取每个字段的详细错误信息。
```
if err != nil {
    for _, err := range err.(validator.ValidationErrors) {
        fmt.Println(err.Field(), err.Tag(), err.Param())
    }
    return
}
```
登录后复制
这样，你就能知道哪个字段违反了哪个规则，以及规则的具体参数。

如何自定义校验规则？

有时候，内置的校验规则不够用，你需要自定义校验规则。validator 库允许你注册自定义的校验函数。

func isCoolEmail(fl validator.FieldLevel) bool {
    email := fl.Field().String()
    // 这里写你的自定义校验逻辑
    return strings.Contains(email, "cool")
}

func main() {
    validate := validator.New()
    validate.RegisterValidation("cool_email", isCoolEmail)

    type User struct {
        Email string `validate:"required,cool_email"`
    }

    user := User{
        Email: "notcool@example.com",
    }

    err := validate.Struct(user)
    if err != nil {
        fmt.Println(err)
    }
}

登录后复制

在这个例子中，我们定义了一个 isCoolEmail 函数，它检查 email 地址是否包含 "cool"。然后，我们使用 RegisterValidation 方法将这个函数注册为 cool_email 校验规则。

如何处理复杂的嵌套结构校验？

如果你的数据结构包含嵌套的结构体，validator 库也能处理。你需要在嵌套的结构体字段上添加 validate:"dive" 标签。

type Address struct {
    Street string `validate:"required"`
    City   string `validate:"required"`
    Zip    string `validate:"required,len=5"`
}

type User struct {
    FirstName string  `validate:"required"`
    LastName  string  `validate:"required"`
    Address   Address `validate:"dive"`
}

登录后复制

dive 标签告诉 validator 库，进入 Address 结构体进行校验。