当前位置：首页 > 文章列表 > Golang > Go教程 > Golang实现Web表单验证码步骤详解

Golang实现Web表单验证码步骤详解

2025-10-05 12:00:34 0浏览收藏

本文详细介绍了如何在Golang中实现Web表单验证码功能，并针对百度SEO进行了优化。核心在于使用`github.com/mojocn/base64Captcha`库快速生成数字验证码，并将其转换为Base64编码的图像，方便前端直接展示。教程涵盖了从后端生成验证码、前端展示验证码图片，到后端验证用户输入的全过程。此外，文章还强调了验证码的安全性和使用建议，包括验证码单次有效、区分大小写问题、过期时间设置以及避免日志泄露等，旨在帮助开发者构建安全可靠的Web表单验证系统。通过本文，开发者可以快速掌握Golang验证码的实现方法，有效防止恶意攻击，提升网站安全性。

使用base64Captcha生成数字验证码并返回Base64图像；2. 前端通过API获取并展示验证码图片；3. 用户提交后，后端根据ID验证输入是否正确；4. 验证码单次有效、区分大小写需注意、建议合理设置过期时间并避免日志泄露。

如何在Golang中实现Web表单验证码

在Golang中实现Web表单验证码，核心是生成随机字符、保存验证码状态、展示图像以及验证用户输入。下面是一个实用且简洁的实现方式，使用标准库和第三方绘图库来完成。

1. 生成验证码并绘制为图片

使用 github.com/golang/freetype 或更简单的 github.com/mojocn/base64Captcha 可以快速生成图形验证码。这里推荐使用 base64Captcha，它支持数字、字符、音频等多种类型，并直接返回Base64编码图像，便于前端展示。

安装依赖：

go get github.com/mojocn/base64Captcha

示例代码生成一个数字验证码：

package main

import (
    "encoding/json"
    "net/http"
    "github.com/mojocn/base64Captcha"
)

var store = base64Captcha.DefaultMemStore

func generateCaptchaHandler(w http.ResponseWriter, r *http.Request) {
    // 配置验证码：4位数字
    driver := base64Captcha.NewDriverDigit(80, 240, 4, 0.7, 80)
    cp := base64Captcha.NewCaptcha(driver, store)
    id, b64s, err := cp.Generate()
    if err != nil {
        http.Error(w, "生成失败", http.StatusInternalServerError)
        return
    }

    // 返回JSON：包含ID和Base64图像
    json.NewEncoder(w).Encode(map[string]string{
        "captcha_id":   id,
        "captcha_image": b64s,
    })
}

2. 前端展示验证码

前端通过请求获取验证码数据，并将Base64图像显示在页面上：

fetch("/captcha")
  .then(res => res.json())
  .then(data => {
    document.getElementById("captcha-img").src = "data:image/png;base64," + data.captcha_image;
    document.getElementById("captcha-id").value = data.captcha_id;
  });

HTML部分：

3. 验证用户提交的验证码

当用户提交表单时，后端根据传入的 captcha_id 和用户输入的值进行比对：

func verifyCaptchaHandler(w http.ResponseWriter, r *http.Request) {
    r.ParseForm()
    captchaID := r.FormValue("captcha_id")
    userCaptcha := r.FormValue("captcha")

    if !store.Verify(captchaID, userCaptcha, true) {
        http.Error(w, "验证码错误", http.StatusBadRequest)
        return
    }

    // 验证成功，继续处理表单
    w.Write([]byte("验证通过"))
}