首页 > 后端开发 > Golang > 正文

Golang实现JWT认证怎么做 生成和验证Token完整流程

P粉602998670
发布: 2025-08-14 17:36:02
原创
814人浏览过

go语言中实现jwt认证的核心是生成和验证token,使用github.com/golang-jwt/jwt/v5库可完成该流程;首先定义包含用户信息和标准声明的claims结构,通过jwt.newwithclaims结合hmac-sha256算法生成签名token,有效期通常设为24小时;在验证时,从请求头authorization: bearer <token>中提取token,利用jwt.parsewithclaims解析并校验签名和过期时间;可通过中间件封装验证逻辑,保护特定路由,确保只有合法token才能访问受保护接口;实际应用中需将密钥存于环境变量、避免硬编码,设置合理过期时间并启用https传输以提升安全性,完整流程包括登录生成token、接口验证、中间件拦截和安全防护措施,适用于中小型项目身份认证需求。

Golang实现JWT认证怎么做 生成和验证Token完整流程

在 Go 语言(Golang)中实现 JWT(JSON Web Token)认证,主要涉及两个核心流程:生成 Token验证 Token。JWT 常用于用户登录后的身份认证,比如 Web API 的权限控制。

下面是一个完整的、实用的 JWT 实现流程,使用广泛使用的第三方库

github.com/golang-jwt/jwt/v5
登录后复制
(原
golang-jwt/jwt
登录后复制
)。


一、安装依赖

go get github.com/golang-jwt/jwt/v5
登录后复制

二、定义密钥和 Token 结构

JWT 通常使用 HMAC、RSA 等算法签名。这里以对称加密的 HMAC-SHA256 为例,使用一个密钥字符串。

立即学习go语言免费学习笔记(深入)”;

package main

import (
    "fmt"
    "net/http"
    "time"

    "github.com/golang-jwt/jwt/v5"
)

// 密钥,应保存在环境变量中
var jwtKey = []byte("your-secret-key-change-in-production")

// 定义用户声明(Claims)
type Claims struct {
    UserID uint   `json:"user_id"`
    Email  string `json:"email"`
    jwt.RegisteredClaims
}
登录后复制
RegisteredClaims 包含标准字段如 ExpiresAt、Issuer、Subject 等。

三、生成 JWT Token

当用户登录成功后,生成一个 Token 并返回给客户端。

func generateToken(userID uint, email string) (string, error) {
    expirationTime := time.Now().Add(24 * time.Hour) // 24小时有效期

    claims := &Claims{
        UserID: userID,
        Email:  email,
        RegisteredClaims: jwt.RegisteredClaims{
            ExpiresAt: jwt.NewNumericDate(expirationTime),
            IssuedAt:  jwt.NewNumericDate(time.Now()),
            NotBefore: jwt.NewNumericDate(time.Now()),
            Issuer:    "your-app-name",
            Subject:   fmt.Sprintf("user-%d", userID),
        },
    }

    // 创建 token 对象
    token := jwt.NewWithClaims(jwt.SigningMethodHS256, claims)

    // 签名并生成字符串
    tokenString, err := token.SignedString(jwtKey)
    if err != nil {
        return "", err
    }

    return tokenString, nil
}
登录后复制

四、验证 JWT Token

在受保护的接口中,从请求头(通常是

Authorization: Bearer <token>
登录后复制
)中提取 Token 并验证。

清程爱画
清程爱画

AI图像与视频生成平台,拥有超丰富的工作流社区和多种图像生成模式。

清程爱画 170
查看详情 清程爱画
func validateToken(tokenString string) (*Claims, error) {
    claims := &Claims{}

    token, err := jwt.ParseWithClaims(tokenString, claims, func(token *jwt.Token) (interface{}, error) {
        // 验证签名算法是否正确
        if _, ok := token.Method.(*jwt.SigningMethodHMAC); !ok {
            return nil, fmt.Errorf("unexpected signing method: %v", token.Header["alg"])
        }
        return jwtKey, nil
    })

    if err != nil {
        return nil, err
    }

    if !token.Valid {
        return nil, fmt.Errorf("invalid token")
    }

    return claims, nil
}
登录后复制

五、中间件封装(用于 Web 路由)

你可以写一个中间件来保护某些路由。

func authMiddleware(next http.HandlerFunc) http.HandlerFunc {
    return func(w http.ResponseWriter, r *http.Request) {
        authHeader := r.Header.Get("Authorization")
        if authHeader == "" {
            http.Error(w, "Authorization header missing", http.StatusUnauthorized)
            return
        }

        // Bearer <token>
        var tokenString string
        if len(authHeader) > 7 && authHeader[:7] == "Bearer " {
            tokenString = authHeader[7:]
        } else {
            http.Error(w, "Invalid authorization format", http.StatusUnauthorized)
            return
        }

        claims, err := validateToken(tokenString)
        if err != nil {
            http.Error(w, "Invalid or expired token", http.StatusUnauthorized)
            return
        }

        // 可将用户信息存入上下文,供后续处理使用
        // 这里简单打印
        fmt.Printf("Authenticated user: %s (ID: %d)\n", claims.Email, claims.UserID)

        next(w, r)
    }
}
登录后复制

六、完整使用示例

func loginHandler(w http.ResponseWriter, r *http.Request) {
    // 模拟登录验证(实际应查数据库)
    email := r.FormValue("email")
    password := r.FormValue("password")

    // 简单模拟验证
    if email == "user@example.com" && password == "pass123" {
        token, err := generateToken(123, email)
        if err != nil {
            http.Error(w, "Failed to generate token", http.StatusInternalServerError)
            return
        }

        w.Header().Set("Content-Type", "application/json")
        fmt.Fprintf(w, `{"token": "%s"}`, token)
        return
    }

    http.Error(w, "Invalid credentials", http.StatusUnauthorized)
}

func protectedHandler(w http.ResponseWriter, r *http.Request) {
    w.Write([]byte("This is a protected route!"))
}

func main() {
    http.HandleFunc("/login", loginHandler)
    http.HandleFunc("/protected", authMiddleware(protectedHandler))

    fmt.Println("Server starting on :8080")
    http.ListenAndServe(":8080", nil)
}
登录后复制

七、测试流程

  1. 登录获取 Token:
curl -X POST http://localhost:8080/login \
  -d "email=user@example.com" \
  -d "password=pass123"
登录后复制

返回:

{"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.xxxxx"}
登录后复制
  1. 访问受保护接口:
curl -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.xxxxx" \
  http://localhost:8080/protected
登录后复制

八、安全建议

  • 密钥不要硬编码:使用环境变量或配置中心管理
    jwtKey
    登录后复制
  • 设置合理过期时间:如 15 分钟到 24 小时,可配合 refresh token。
  • HTTPS 传输:防止 Token 被窃取。
  • 避免存储敏感信息:JWT 可被解码(只是不加密),不要放密码等。
  • 考虑使用
    jti
    登录后复制
    防重放攻击
    :为每个 Token 设置唯一 ID。
  • 刷新机制:长期登录可用 Refresh Token 机制。

总结

Golang 实现 JWT 认证的关键步骤:

  • 定义自定义
    Claims
    登录后复制
    结构
  • 使用
    jwt.NewWithClaims
    登录后复制
    生成 Token
  • 使用
    jwt.ParseWithClaims
    登录后复制
    验证 Token
  • 中间件提取并验证
    Authorization
    登录后复制
  • 合理设置过期时间与密钥管理

这套流程足够用于中小型项目。如需更高安全级别,可升级为 RSA 非对称加密或集成 OAuth2。

基本上就这些,不复杂但容易忽略细节。

以上就是Golang实现JWT认证怎么做 生成和验证Token完整流程的详细内容,更多请关注php中文网其它相关文章!

最佳 Windows 性能的顶级免费优化软件
最佳 Windows 性能的顶级免费优化软件

每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
热门推荐
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新 English
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送
PHP中文网APP
随时随地碎片化学习

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号