Gin框架下使用JWT进行非对称加密Token签名-Golang-PHP中文网

因为jwt.SigningMethodRS256仅是算法标识，签名需rsa.PrivateKey、验签需rsa.PublicKey，二者缺一不可；若未正确加载或格式不匹配（如PKCS#1/PKCS#8混淆、SSH公钥误作X.509），将导致panic或crypto/rsa: verification error。

gin框架下使用jwt进行非对称加密token签名

为什么不能直接用 `jwt.SigningMethodRS256` 而不配公私钥对

因为 jwt.SigningMethodRS256 本身只是算法标识，不携带密钥；签名和验签必须显式传入 *rsa.PrivateKey 和 *rsa.PublicKey。Gin 中常见错误是只初始化了 SigningMethod，却忘了加载私钥签名、或用错公钥格式（比如 PEM 未解析、base64 编码后直接当字符串用）。

实操建议：

私钥文件（如 private.key）需用 rsa.ParsePKCS1PrivateKey 或 rsa.ParsePKCS8PrivateKey 解析，取决于生成方式（OpenSSL 默认 PKCS#1，Go ssh-keygen 默认 PKCS#8）
公钥必须从私钥导出，或单独加载 PEM 后用 rsa.ParsePKIXPublicKey（对应 X.509 格式），不能用 ParsePKCS1PublicKey 加载由 ssh-keygen -f pub.pem -e -m pem 生成的“PEM-encoded public key”——它不是标准 PKIX 格式
若验签时 panic 报 crypto/rsa: verification error，大概率是公钥类型不匹配或 Token header 中 alg 字段与实际签名方法不一致（比如 header 写了 RS256，但代码里用了 HS256 私钥签）

如何在 Gin 中安全注入私钥并签名 Token

不要把私钥硬编码或通过环境变量明文传入；推荐启动时读取文件并缓存为 *rsa.PrivateKey 类型变量。Gin 的 context 不适合存密钥，应放在全局变量或依赖容器中。

示例签名逻辑（精简）：

func generateToken(userID string, privKey *rsa.PrivateKey) (string, error) {
    token := jwt.NewWithClaims(jwt.SigningMethodRS256, jwt.MapClaims{
        "sub": userID,
        "exp": time.Now().Add(24 * time.Hour).Unix(),
    })
    return token.SignedString(privKey)
}

注意点：

jwt.NewWithClaims 第二个参数必须是 jwt.Claims 接口实现，jwt.MapClaims 可用，但生产建议定义结构体并嵌入 jwt.StandardClaims
调用 SignedString 传入的是 *rsa.PrivateKey，不是 interface{} 或字符串；传错类型会 panic
若用 token.Header["kid"] 标识密钥版本，需在签名前手动设置，并确保验签方能按 kid 查到对应公钥

如何在 Gin 中中间件里用公钥验签并提取用户信息

验签失败通常不报具体原因，只会返回 token is invalid 类似模糊错误。关键要捕获 *jwt.ValidationError 并检查 Errors 位掩码。

中间件核心逻辑：

Token Analyzer

基于官方 GMGN API 的代币分析工具。通过合约地址查询代币在 SOL/BSC/Base 链上的准确市场数据、安全检测、KOL 分析、开发者分析和 AI 智能分析（叙事/筹码/老鼠仓/机器人）。支持自动识别链。

下载

func AuthMiddleware(pubKey *rsa.PublicKey) gin.HandlerFunc {
    return func(c *gin.Context) {
        authHeader := c.GetHeader("Authorization")
        if !strings.HasPrefix(authHeader, "Bearer ") {
            c.AbortWithStatusJSON(401, gin.H{"error": "missing or malformed bearer token"})
            return
        }
        tokenStr := strings.TrimPrefix(authHeader, "Bearer ")
<pre class="brush:php;toolbar:false;">    token, err := jwt.Parse(tokenStr, func(token *jwt.Token) (interface{}, error) {
        if _, ok := token.Method.(*jwt.SigningMethodRSA); !ok {
            return nil, fmt.Errorf("unexpected signing method: %v", token.Header["alg"])
        }
        return pubKey, nil
    })

    if err != nil {
        var ve *jwt.ValidationError
        if errors.As(err, &ve) {
            switch ve.Errors {
            case jwt.ValidationErrorExpired:
                c.AbortWithStatusJSON(401, gin.H{"error": "token expired"})
                return
            default:
                c.AbortWithStatusJSON(401, gin.H{"error": "invalid token"})
                return
            }
        }
        c.AbortWithStatusJSON(401, gin.H{"error": "parse error"})
        return
    }

    if !token.Valid {
        c.AbortWithStatusJSON(401, gin.H{"error": "token invalid"})
        return
    }

    claims, ok := token.Claims.(jwt.MapClaims)
    if !ok || !token.Valid {
        c.AbortWithStatusJSON(401, gin.H{"error": "invalid claims"})
        return
    }
    c.Set("userID", claims["sub"])
    c.Next()
}

}

要点：

回调函数返回的公钥必须是 *rsa.PublicKey，不能是 interface{} 包装或 any
务必检查 token.Method 类型，避免被篡改 header 中的 alg 导致算法混淆（例如将 RS256 改成 none）
Gin 的 c.Set 是线程安全的，但值只在当前请求生命周期有效；别试图在 goroutine 里读它

私钥生成与 PEM 格式兼容性陷阱

OpenSSL 生成的私钥默认是 PKCS#1 格式，Go 的 rsa.ParsePKCS1PrivateKey 能读；但用 ssh-keygen -t rsa -b 2048 -f private.key 生成的是 PKCS#8，必须用 rsa.ParsePKCS8PrivateKey。

快速验证方式：

用 head -n 1 private.key 看首行：若为 -----BEGIN RSA PRIVATE KEY----- → PKCS#1；若为 -----BEGIN PRIVATE KEY----- → PKCS#8
公钥文件若由 ssh-keygen -f private.key -y > public.pem 生成，得到的是 SSH 格式，不能直接被 Go 的 ParsePKIXPublicKey 读；需用 openssl rsa -in private.key -pubout -out public.pem 生成标准 X.509 PEM 公钥
所有 PEM 块必须以换行结尾，否则 bytes.Contains 检查失败，ParseXXX 会静默返回 nil