java中正确读取google cloud服务账户私钥需先移除pem头尾及换行符，再base64解码为字节数组，最后用pkcs8encodedkeyspec构建rsaprivatekey，否则会因格式不符抛出invalidkeyspecexception。
立即进入“夸克ai手把手教你，操作像呼吸一样简单！☜☜☜☜☜点击进入”；
直接用 jwt.ParseRSAPrivateKeyFromPEM 和 jwt.ParseRSAPublicKeyFromPEM 就能跑通，但密钥格式不对、算法不匹配、签名验证失败这三类问题占了实际接入的 80% 以上。
加载 PEM 格式私钥时 panic: "invalid key" 是因为格式不标准
Go 的 jwt 库（如 github.com/golang-jwt/jwt/v5）只认标准 PEM 块，且必须带换行符和正确头尾标记。OpenSSL 生成的 rsa_private_key.pem 如果是单行或缺少 -----BEGIN RSA PRIVATE KEY-----，ParseRSAPrivateKeyFromPEM 会直接返回 nil + error。
- ✅ 正确做法：用
openssl pkcs8 -topk8 -inform PEM -outform PEM -in rsa_private_key.pem -out private_key_pkcs8.pem -nocrypt转成 PKCS#8 格式（头为-----BEGIN PRIVATE KEY-----），再传给jwt.ParseRSAPrivateKeyFromPEM - ⚠️ 常见错误：直接用
genrsa生成的旧格式（PKCS#1），头是-----BEGIN RSA PRIVATE KEY-----，Go 的crypto/rsa可读，但新版golang-jwt/jwt默认拒绝 - ? 验证方式：用
file private_key_pkcs8.pem看输出是否含PEM RSA private key；或用openssl rsa -in private_key_pkcs8.pem -check -noout确认可解析
JWT 签名算法选 RS256 还是 RS512？别只看数字大小
RS256 和 RS512 不是“越大的数字越安全”，而是哈希摘要算法不同：RS256 用 SHA-256，RS512 用 SHA-512。实际安全性差异极小，但影响兼容性和性能。
- ✅ 推荐默认用
jwt.SigningMethodRS256：几乎所有客户端（前端 JWT 库、Postman、curl + jwt-cli）都原生支持，Gin 中无需额外配置 - ⚠️
RS512容易踩坑：某些旧版 Java JWT 库（如 jjwt 0.9.x）不支持；Go 的golang-jwt/jwtv5 支持，但若你用的是老版本dgrijalva/jwt-go（已归档），它根本不识别SigningMethodRS512 - ? 检查方式：打印
token.Method.Alg()看是否为"RS256"；解析时若报错"unknown signing method"，大概率是算法不匹配
公钥校验失败：InvalidSignature 错误的三个真实原因
拿到 token 后调用 token, err := jwt.ParseWithClaims(..., func(t *jwt.Token) (interface{}, error) { return publicKey, nil }) 返回 err != nil 且提示 InvalidSignature，常见原因不是“公钥错了”，而是：
- ❌ 公钥文件被意外修改（比如 Windows 编辑器加了 BOM 或 CR/LF 混用），导致
ParseRSAPublicKeyFromPEM解析出错但没显式报错——建议用strings.TrimSpace()处理读入的字节流再解析 - ❌ token 是用私钥 A 签的，但校验时用了私钥 B 对应的公钥（密钥对不匹配），这种情况不会报错，但签名必然失败
- ❌ Gin 中间件里没设
token, err := jwt.ParseWithClaims(tokenString, &claims, keyFunc)的keyFunc返回值类型不对：必须返回interface{}，不能直接返回*rsa.PublicKey（Go 类型系统会静默失败）
Gin 中间件里解析 JWT 时，claims 结构体字段必须导出
如果你定义了自定义 claims：type CustomClaims struct { UserID string `json:"user_id"` }，但忘记首字母大写，比如写成 userid string，jwt.ParseWithClaims 会静默跳过赋值，导致后续逻辑取到空值。
- ✅ 必须满足 Go 的导出规则：字段名首字母大写，且 JSON tag 显式声明（如
`json:"user_id"`） - ⚠️ 别依赖 IDE 自动补全：有些模板生成的 struct 字段是小写，复制粘贴后没改，运行时不报错但数据为空
- ? 快速验证：在中间件里加一行
log.Printf("claims: %+v", claims)，看字段是否被填充
最麻烦的其实是密钥生命周期管理——RSA 密钥对一旦上线，就不能轻易轮换，否则所有存量 token 都会验证失败。别想着“先换公钥再发新 token”，得留够 token 过期窗口（比如 24 小时）让旧 token 自然失效，同时确保服务端能按需加载多组公钥做 fallback 校验。
