go-jose 与 golang-jwt 的关键区别在于：前者是贴近 jose 规范的底层库，需显式构造 signer/encrypter 并处理序列化、算法匹配等细节；后者提供开箱即用的 jwt.parse 等封装，适合简单 jwt 场景。
go-jose 与 golang-jwt 的关键区别在哪
别直接套用 golang-jwt/jwt 的习惯写法——go-jose/v4 不是它的替代品，而是更底层、更贴近 JOSE 规范的实现。它不提供 jwt.Parse 这类“开箱即用”的封装函数，所有 JWS/JWE 操作都需显式构造 jose.Signer、jose.Encrypter 或 jose.Decrypter。这意味着你必须自己处理序列化格式（compact vs. JSON）、密钥类型匹配、算法协商等细节。
常见错误现象：panic: unsupported algorithm 或 invalid signature，往往是因为传入了不兼容的密钥（比如用 HS256 签名却传了 RSA 私钥），或没按 RFC 7515/7516 要求设置 Header 字段。
-
golang-jwt隐藏了 JWS compact 序列化的细节，适合快速签发/验证简单 token -
go-jose强制你明确选择：是生成compact（xxxxx.yyyyy.zzzzz）还是JSON格式？是否启用压缩？是否支持多签名/多接收者？ - 若只需 HS256/RS256 基础 JWT，
golang-jwt更轻量；若要 JWE 加密、ECDH 密钥协商、或带分离载荷的 JWS，go-jose是唯一可靠选择
用 go-jose 实现 JWS 签名（HS256 和 RS256）
签名不是调一个 Sign() 就完事——你要先创建 jose.Signer，再用它包装原始 claims 数据。密钥类型和算法必须严格对应。
HS256 示例（对称密钥）：
signer, err := jose.NewSigner(jose.SigningKey{Algorithm: jose.HS256, Key: []byte("my-secret")}, &jose.SignerOptions{ContentType: "JWT"})
if err != nil {
panic(err)
}
cl := jwt.Claims{Subject: "user-123", Expiry: jwt.NewNumericDate(time.Now().Add(1 * time.Hour))}
raw, err := json.Marshal(cl)
if err != nil {
panic(err)
}
signed, err := signer.Sign(raw) // 注意：输入是 []byte，不是 jwt.Claims 对象
if err != nil {
panic(err)
}
tokenString, err := signed.CompactSerialize() // 必须显式序列化
RS256 示例（非对称密钥）：
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
privKey, _ := rsa.GenerateKey(rand.Reader, 2048)
signer, _ := jose.NewSigner(jose.SigningKey{Algorithm: jose.RS256, Key: privKey}, nil)
// 后续同上：Marshal → Sign → CompactSerialize
- 不能把
jwt.Claims直接传给Sign()，必须先json.Marshal -
CompactSerialize()返回字符串；FullSerialize()返回 JSON 格式（含 header/payload/signature 字段） - 验证时要用
jose.ParseSigned()解析，再用Verify()+ 公钥校验，不能直接用jwt.Parse
用 go-jose 实现 JWE 加密（AES-GCM + RSA-OAEP）
JWE 不是“加密 JWT”，而是加密任意 JSON payload（可以是 JWT，也可以是其他结构）。go-jose 要求你分两步：先构造 jose.Encrypter，再用它加密数据。
典型组合：RSA-OAEP 密钥加密 + AES-GCM 内容加密：
pubKey, _ := rsa.GenerateKey(rand.Reader, 2048).PublicKey
encrypter, _ := jose.NewEncrypter(jose.A128GCM, jose.Recipient{Algorithm: jose.RSAOAEP, Key: pubKey}, nil)
payload := []byte(`{"user_id":123,"role":"admin"}`)
encrypted, _ := encrypter.Encrypt(payload)
jweString, _ := encrypted.CompactSerialize()
解密时必须用对应私钥：
jwe, _ := jose.ParseEncrypted(jweString) decrypted, _ := jwe.Decrypt(privKey) // privKey 是上面生成的私钥
-
jose.A128GCM是内容加密算法，jose.RSAOAEP是密钥加密算法——顺序不能颠倒 - 如果用
dir（直接加密），则不需要Recipient，但密钥必须是 AES 密钥（[]byte），且长度必须匹配（如A128GCM要求 16 字节） - JWE compact 格式是
aaaaa.bbbbb.ccccc.ddddd（5 段），比 JWS 多一段加密密钥
容易被忽略的密钥管理与错误处理
go-jose 把密钥安全责任完全交给使用者。它不会帮你生成、存储或轮换密钥，也不会自动拒绝弱密钥（比如 1024 位 RSA）。
实际部署中必须注意：
- RSA 密钥至少 2048 位；ECDSA 推荐
P-256或P-384；AES 密钥必须用密码学安全随机数生成（crypto/rand） - 错误类型很细：可能是
jose.ErrUnsupportedAlgorithm（算法不支持）、jose.ErrCryptoFailure（底层加解密失败）、jose.ErrInvalidKey（密钥格式错误）——建议用errors.Is()区分处理 - 解析 JWS/JWE 时，
ParseSigned()和ParseEncrypted()都可能返回nil+ error，但不会 panic；而Sign()/Encrypt()失败会直接 panic，务必提前校验输入 - 不要在日志里打印完整 JWS/JWE 字符串——compact 格式虽不可读，但 header 可能泄露算法信息（如
"alg":"HS256"）
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
