Go 语言实现邮箱地址有效性校验算法及源码

Go 提供：

import "net/mail"

核心函数：

mail.ParseAddress()

但问题：

• 过于宽松
• 不适合严格业务校验

因此我们实现自定义严格版本。

正则表达式（regexp）

用于校验：

• local 部分
• 域名格式

设计原则

• 单一职责
• 可配置
• 易扩展
• 错误明确

实现思路

整体流程：

1. 判空
2. 长度校验
3. 拆分 @
4. 校验 local 部分
5. 校验 domain 部分
6. 校验域名规则
7. 返回结果

设计结构体

type EmailValidator struct {
    MaxLength int
}

校验逻辑分层

• 主校验函数
• 校验 local 部分
• 校验 domain 部分
• 校验 IP 域名（可选）

关键规则设计

local 允许字符：

a-z A-Z 0-9 . _ % + -

domain 规则：

^([a-zA-Z0-9-]+\.)+[a-zA-Z]{2,}$

完整实现代码

// ============================= // file: validator/email_validator.go // =============================
package validator

import (
    "errors"
    "net"
    "regexp"
    "strings"
)

// EmailValidator 邮箱校验结构体
type EmailValidator struct {
    // 最大邮箱长度（默认 254）
    MaxLength int
}

// NewEmailValidator 构造函数
func NewEmailValidator() *EmailValidator {
    return &EmailValidator{
        MaxLength: 254,
    }
}

// IsValid 校验邮箱是否合法
func (v *EmailValidator) IsValid(email string) (bool, error) {
    // 1. 去除空格
    email = strings.TrimSpace(email)
    // 2. 判空
    if email == "" {
        return false, errors.New("邮箱不能为空")
    }
    // 3. 长度校验
    if len(email) > v.MaxLength {
        return false, errors.New("邮箱长度超过限制")
    }
    // 4. 必须包含且仅包含一个@
    if strings.Count(email, "@") != 1 {
        return false, errors.New("邮箱必须包含一个@符号")
    }
    // 5. 拆分 local 和 domain
    parts := strings.Split(email, "@")
    local := parts[0]
    domain := parts[1]
    // 6. 校验 local 部分
    if !isValidLocal(local) {
        return false, errors.New("非法的 local 部分")
    }
    // 7. 校验 domain 部分
    if !isValidDomain(domain) {
        return false, errors.New("非法的 domain 部分")
    }
    return true, nil
}

// isValidLocal 校验 local 部分
func isValidLocal(local string) bool {
    // 长度限制（RFC 建议 64）
    if len(local) == 0 || len(local) > 64 {
        return false
    }
    // 不允许以。开头或结尾
    if strings.HasPrefix(local, ".") || strings.HasSuffix(local, ".") {
        return false
    }
    // 不允许连续..
    if strings.Contains(local, "..") {
        return false
    }
    // 允许字符正则
    var localRegex = regexp.MustCompile(`^[a-zA-Z0-9._%+\-]+$`)
    return localRegex.MatchString(local)
}

// isValidDomain 校验 domain 部分
func isValidDomain(domain string) bool {
    // 不允许为空
    if domain == "" {
        return false
    }
    // 优先判断是否为 IP 地址
    if net.ParseIP(domain) != nil {
        return true
    }
    // 域名正则
    var domainRegex = regexp.MustCompile(`^([a-zA-Z0-9-]+\.)+[a-zA-Z]{2,}$`)
    return domainRegex.MatchString(domain)
}

// ============================= // file: main.go // =============================
package main

import (
    "fmt"
    "emailvalidator/validator"
)

func main() {
    v := validator.NewEmailValidator()
    testCases := []string{
        "[email protected]",
        "[email protected]",
        "invalidemail.com",
        "test@@example.com",
        "[email protected]",
        "[email protected]",
    }
    for _, t := range testCases {
        valid, err := v.IsValid(t)
        fmt.Println("邮箱:", t)
        fmt.Println("是否有效:", valid)
        fmt.Println("错误:", err)
        fmt.Println("-------------------")
    }
}

代码详细解读

NewEmailValidator

初始化邮箱校验器，默认最大长度 254。

IsValid

主校验函数。

完成：

• 去空格
• 判空
• 长度限制
• @数量校验
• 拆分 local 和 domain
• 分别校验

isValidLocal

校验本地部分：

• 长度限制
• 不允许。开头结尾
• 不允许连续。。
• 正则匹配合法字符

isValidDomain

校验域名部分：

• 非空
• 支持 IP 地址
• 正则匹配合法域名

项目总结

本项目实现了一个：

✔ 严格邮箱校验器 ✔ 支持 IP 域名 ✔ 支持长度控制 ✔ 支持错误返回 ✔ 易扩展

相比直接使用 net/mail.ParseAddress()，本实现：

• 更可控
• 更严格
• 更适合业务场景

适用于：

• 用户注册系统
• 企业管理系统
• 数据清洗工具
• 邮件发送服务

常见问题及解答

Q1：为什么不用 net/mail？

过于宽松，不适合严格校验。

Q2：是否支持 IPv6？

当前版本支持 IP 判断，但未专门强化 IPv6 格式。

Q3：是否支持国际邮箱？

当前版本不支持 IDN 国际域名。

Q4：如何支持公司内部邮箱规则？

可扩展：

AllowedDomains []string

扩展方向与性能优化

1. 支持国际化域名（IDN）

使用：

golang.org/x/net/idna

2. 支持域名黑名单

添加黑名单列表。

3. 支持 MX 记录校验（高级）

使用：

net.LookupMX()

验证域名是否真实存在邮件服务器。

4. 单元测试

使用：

go test

结语

本教程完整实现了：

Go 语言判断字符串是否为有效电子邮件地址算法。