golang-jwt 用于 Go：完整指南及示例

\n\n

golang-jwt 库（官方名称为 github.com/golang-jwt/jwt/v5）是 Go 语言中 JSON Web Tokens (JWT) 的事实标准实现。它为开发者提供了强大且灵活的工具集，用于创建、签名、验证和解码 JWT 令牌。JWT 是一种紧凑且自包含的方式，以 JSON 对象的形式在各方之间传输信息，该对象可以被验证，因为它带有数字签名。JWT 令牌广泛用于 REST API、微服务架构和 Web 应用程序中的身份验证、授权和安全数据交换。

\n\n

为什么需要这个库？在现代 Go 网络开发中，几乎所有需要用户身份验证的应用程序（例如 API 服务器、微服务、单点登录系统）都会遇到处理 JWT 的需求。golang-jwt 库承担了所有复杂性：生成和验证签名（HMAC、RSA、ECDSA、EdDSA）、解析标头和有效载荷、处理标准字段（exp、iat、iss、sub）以及自定义声明。没有它，您将不得不手动实现加密操作和 JSON 解析，这容易导致错误和漏洞。

\n\n

golang-jwt 的主要优势：完全支持 RFC 7519 规范、通过流畅接口易于使用、高性能（使用标准 crypto 库）、可通过自定义签名方法和验证器进行扩展。该库由社区积极维护，在 GitHub 上拥有超过 7000 颗星，并用于 Kubernetes、Docker、Grafana 等众多项目中。

\n\n

安装

该库的安装通过 Go 的标准方式 go get 进行。请确保您已安装 Go 1.18 或更高版本（建议使用 1.21+）。

\n\n

go get github.com/golang-jwt/jwt/v5

\n\n

执行命令后，您的 go.mod 文件中将出现该依赖项。在代码中导入库的方式如下：

\n\n

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

\n\n

快速入门 — 最小工作示例

让我们创建一个简单示例：使用对称密钥（HMAC-SHA256）生成和验证 JWT 令牌。

\n\n

package main\n\nimport (\n    "fmt"\n    "time"\n    "github.com/golang-jwt/jwt/v5"\n)\n\nfunc main() {\n    // 1. 密钥（必须安全存储）\n    secretKey := []byte("my-super-secret-key-12345")\n\n    // 2. 创建令牌\n    claims := jwt.MapClaims{\n        "user_id": 12345,\n        "role":    "admin",\n        "exp":     time.Now().Add(time.Hour * 24).Unix(), // 过期时间 24 小时\n        "iat":     time.Now().Unix(),                     // 创建时间\n    }\n\n    token := jwt.NewWithClaims(jwt.SigningMethodHS256, claims)\n    tokenString, err := token.SignedString(secretKey)\n    if err != nil {\n        panic(err)\n    }\n    fmt.Println("生成的令牌:", tokenString)\n\n    // 3. 验证并解析令牌\n    parsedToken, err := jwt.Parse(tokenString, func(token *jwt.Token) (interface{}, error) {\n        // 检查签名方法是否为 HMAC\n        if _, ok := token.Method.(*jwt.SigningMethodHMAC); !ok {\n            return nil, fmt.Errorf("意外的签名方法: %v", token.Header["alg"])\n        }\n        return secretKey, nil\n    })\n\n    if err != nil {\n        panic(err)\n    }\n\n    // 4. 提取声明\n    if claims, ok := parsedToken.Claims.(jwt.MapClaims); ok && parsedToken.Valid {\n        fmt.Printf("用户 ID: %v\\n", claims["user_id"])\n        fmt.Printf("角色: %v\\n", claims["role"])\n    } else {\n        fmt.Println("令牌无效")\n    }\n}

\n\n