如何在Golang中实现表单验证_使用自定义函数检查输入合法性

在Golang的Web开发中，表单验证是保障接口数据合法性的重要步骤，使用自定义函数实现验证可以灵活适配不同业务的特殊规则，不需要强依赖第三方库，也能让验证逻辑更贴合项目需求。

自定义表单验证的基本思路

自定义表单验证的核心是将验证规则封装为独立函数，接收表单数据作为输入，返回验证结果和错误信息。我们可以将不同类型的验证规则拆分成单个函数，再根据业务需求组合调用这些函数。

定义表单数据结构

首先定义承载表单数据的结构体，结构体字段对应表单的输入项，同时可以添加标签用于存储验证规则的提示信息：

package main

import (
	"fmt"
	"strings"
)

// 定义用户注册表单结构体
type RegisterForm struct {
	Username string // 用户名
	Email    string // 邮箱
	Password string // 密码
}

// 定义验证错误结构体，用于存储字段和对应的错误信息
type ValidationError struct {
	Field   string
	Message string
}

编写单个验证规则函数

针对每个输入项的不同规则，编写独立的验证函数，函数接收待验证的值和相关参数，返回布尔值表示是否通过验证：

// 验证字符串长度是否在指定范围内
func ValidateLength(input string, minLen, maxLen int) bool {
	length := len([]rune(input)) // 处理中文等多字节字符
	if length < minLen || length > maxLen {
		return false
	}
	return true
}

// 验证邮箱格式是否合法，简单校验包含@和.
func ValidateEmailFormat(email string) bool {
	if !strings.Contains(email, "@") {
		return false
	}
	if !strings.Contains(email, ".") {
		return false
	}
	// 简单校验@不在开头和结尾
	atIndex := strings.Index(email, "@")
	if atIndex == 0 || atIndex == len(email)-1 {
		return false
	}
	return true
}

// 验证密码是否包含字母和数字
func ValidatePasswordComplexity(password string) bool {
	hasLetter := false
	hasNumber := false
	for _, c := range password {
		if (c >= 'a' && c <= 'z') || (c >= 'A' && c <= 'Z') {
			hasLetter = true
		}
		if c >= '0' && c <= '9' {
			hasNumber = true
		}
	}
	return hasLetter && hasNumber
}

组合验证逻辑

编写一个统一的验证入口函数，调用上述单个规则函数，收集所有验证错误，返回错误列表：

// 验证注册表单，返回所有错误信息
func ValidateRegisterForm(form RegisterForm) []ValidationError {
	var errors []ValidationError

	// 验证用户名：长度3-20位
	if !ValidateLength(form.Username, 3, 20) {
		errors = append(errors, ValidationError{
			Field:   "Username",
			Message: "用户名长度需要在3到20位之间",
		})
	}

	// 验证邮箱格式
	if !ValidateEmailFormat(form.Email) {
		errors = append(errors, ValidationError{
			Field:   "Email",
			Message: "邮箱格式不合法",
		})
	}

	// 验证密码：长度6-32位，且包含字母和数字
	if !ValidateLength(form.Password, 6, 32) {
		errors = append(errors, ValidationError{
			Field:   "Password",
			Message: "密码长度需要在6到32位之间",
		})
	} else if !ValidatePasswordComplexity(form.Password) {
		errors = append(errors, ValidationError{
			Field:   "Password",
			Message: "密码需要同时包含字母和数字",
		})
	}

	return errors
}

实际使用示例

在Web接口中接收表单数据后，调用验证函数处理，根据错误列表返回对应的响应：

func main() {
	// 模拟接收的表单数据
	testForm := RegisterForm{
		Username: "ab",
		Email:    "testippipp.com",
		Password: "123456",
	}

	// 执行验证
	errors := ValidateRegisterForm(testForm)

	// 处理验证结果
	if len(errors) > 0 {
		fmt.Println("表单验证失败，错误信息：")
		for _, err := range errors {
			fmt.Printf("字段：%s，错误：%sn", err.Field, err.Message)
		}
	} else {
		fmt.Println("表单验证通过")
	}
}

扩展验证能力

如果后续需要添加新的验证规则，只需要新增对应的验证函数，再在ValidateRegisterForm中调用即可，比如添加手机号验证规则：

// 验证手机号格式，简单校验11位数字
func ValidatePhoneFormat(phone string) bool {
	if len(phone) != 11 {
		return false
	}
	for _, c := range phone {
		if c < '0' || c > '9' {
			return false
		}
	}
	return true
}

这种自定义验证的方式灵活度高，所有验证逻辑都在项目内可见，方便后续维护和调整规则，也避免了引入第三方库带来的额外依赖。

Golang表单验证自定义函数input_合法性检查修改时间：2026-06-30 07:54:32