Go语言Beego框架JWT身份认证实现示例

小鹿同学

发布时间：2026-10-16 | 5人浏览过

原创

在Go Web开发中，利用JSON Web Token实现无状态的身份验证是提升系统安全性的标准做法。本文将演示如何在Beego框架下，通过安装jwt-go库，定制Payload数据结构，并实现完整的Token签发、校验与刷新逻辑，供后端开发者参考。

一、准备工作：引入依赖

开始之前，需要确保本地已安装Go环境，并使用Go Modules管理依赖。首先执行以下命令拉取 jwt-go 第三方库：

go get github.com/dgrijalva/jwt-go

二、配置核心参数与模型

在项目的业务代码文件中，导入必要的包。我们需要定义全局的密钥常量 KEY 和默认过期时间 DEFAULT_EXPIRE_SECONDS，以及用于承载用户信息的结构体。

为了扩展性，我们创建一个继承自 jwt.StandardClaims 的自定义结构体 MyCustomClaims，将具体的用户数据嵌入其中。

import (
	"fmt"
	"github.com/astaxie/beego"
	"github.com/dgrijalva/jwt-go"
	"time"
)

const (
	// 加盐密钥，实际项目中请更换为强随机字符串
	KEY                    string = "JWT-ARY-STARK"
	// 默认有效期为600秒
	DEFAULT_EXPIRE_SECONDS int    = 600 
)

// 模拟的用户表结构
type User struct {
	Id   string `json:"id"`
	Name string `json:"name"` //注意此处json标签应为name，原稿可能有误
}

// MyCustomClaims 承载负载(Payload)数据
type MyCustomClaims struct {
	User             // 嵌入自定义用户字段
	jwt.StandardClaims // 内置的标准声明(过期时间等)
}

三、封装核心操作方法

为了实现规范的鉴权流程，我们将核心的操作抽象为三个函数：GenerateToken（生成）、ValidateToken（解析验证）和 RefreshToken（刷新）。

第1步：获取JWT Token（生成签名）

目的：用户登录成功后，颁发带有签名的Token给前端。

动作说明：设置过期时间，填入IssuedAt、Issuer等信息，使用指定算法(HS256)和密钥生成签名字符串。

// 生成token
func GenerateToken(info *User, expiredSeconds int) (tokenString string, err error) {
	if expiredSeconds == 0 {
		expiredSeconds = DEFAULT_EXPIRE_SECONDS
	}
	mySigningKey := []byte(KEY)
	expireAt := time.Now().Add(time.Second * time.Duration(expiredSeconds)).Unix()
	
	claims := MyCustomClaims{
		*info,
		jwt.StandardClaims{
			ExpiresAt: expireAt,
			Issuer:    info.Name,
			IssuedAt:  time.Now().Unix(),
		},
	}
	token := jwt.NewWithClaims(jwt.SigningMethodHS256, claims)
	tokenStr, err := token.SignedString(mySigningKey)
	return tokenStr, err
}

第2步：验证JWT Token

目的：拦截后续API请求，判断Token是否有效且未被篡改。

动作说明：解析Token时指定回调函数返回Secret Key。若解析成功且 token.Valid 为真，则提取出用户信息。

// 验证token
func ValidateToken(tokenString string) (info User, err error) {
	token, err := jwt.ParseWithClaims(
		tokenString,
		&MyCustomClaims{},
		func(token *jwt.Token) (interface{}, error) {
			return []byte(KEY), nil
		})
	
	if claims, ok := token.Claims.(*MyCustomClaims); ok && token.Valid {
		info = claims.User
	} else {
		fmt.Println("validate tokenString failed !!!", err)
	}
	return
}

第3步：刷新JWT Token

目的：在旧Token即将过期前，为其续期。

动作说明：解析旧Token -> 检查有效性 -> 基于旧Claim创建新Token并重新签名。

// 刷新token
func RefreshToken(tokenString string) (string, error) {
	token, err := jwt.ParseWithClaims(
		tokenString,
		&MyCustomClaims{},
		func(token *jwt.Token) (interface{}, error) {
			return []byte(KEY), nil
		})
	claims, ok := token.Claims.(*MyCustomClaims)
	if !ok || !token.Valid {
		return "", err
	}

	expireAt := time.Now().Add(time.Second * time.Duration(DEFAULT_EXPIRE_SECONDS)).Unix()
	newClaims := MyCustomClaims{
		claims.User,
		jwt.StandardClaims{
			ExpiresAt: expireAt,
			Issuer:    claims.User.Name,
			IssuedAt:  time.Now().Unix(),
		},
	}
	newToken := jwt.NewWithClaims(jwt.SigningMethodHS256, newClaims)
	tokenStr, err := newToken.SignedString([]byte(KEY))
	return tokenStr, err
}

第4步：组装响应Header格式

为了方便前端直接读取，我们可以提供一个辅助函数来处理Bearer Header的组装：

func getHeaderTokenValue(tokenString string) string {
	return fmt.Sprintf("Bearer %s", tokenString)
}

四、在Beego Controller中使用

完成上述封装后，即可在具体业务控制器中调用。假设有一个名为 UserController：

第1步：登录并返回Token

入口：GET /user/login

动作：初始化用户对象，调用 GenerateToken，并将生成的Token写入响应体。前端需保存该Token并在请求头携带 Authorization: Bearer <token> 。

func (this *UserController) Get() {
	user := User{Id: "1", Name: "gangan"}
	token, err := GenerateToken(&user, 0)
	if err != nil {
		this.Ctx.WriteString(err.Error())
		return
	}
	this.Ctx.WriteString(token)
}

第2步：接口鉴权（验证Token）

入口：GET /user/check

动作：从请求上下文或外部变量获取用户传来的Token字符串，调用 ValidateToken。如果解析失败，则中断运行；如果成功，则取出其中的用户信息继续业务逻辑。

func (this *UserController) Check() {
	// 实际场景应从 request header 获取 token
	// token := this.Ctx.Input.Header("Authorization")
	token := "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6MSwianNvbiI6ImdhbmdhbiIsImV4cCI6MTU3ODU1NDMyOCwiaWF0IjoxNTc4NTUzNzI4LCJpc3MiOiJnYW5nYW4ifQ.jOlMlfLMFBJvyrJTLagrwQx2931LzM7Z0EVMFZ75xYI"
	
	info, err := ValidateToken(token)
	if err != nil || info.Id == "" { // 简易校验
		this.Ctx.WriteString("invalid token")
		this.StopRun()
	}
	fmt.Println("Parsed user:", info)
	this.Ctx.WriteString("success")
}