Base64编解码密钥后出现JWT Signature Exception问题求助

问题场景 #

使用Keys.keyPairFor(SignatureAlgorithm.RS256)生成RSA密钥对，将私钥、公钥做Base64URL编码后存储。解码后尝试生成、验证JWT时触发io.jsonwebtoken.security.SignatureException，提示签名不匹配；直接使用原始密钥对则无异常，需将密钥字符串存入配置文件。

错误原因 #

代码误用了Keys.hmacShaKeyFor()方法——该方法用于生成HMAC对称加密算法的密钥，而RS256属于RSA非对称加密算法，必须将解码后的字节数组还原为标准的RSA私钥/公钥对象，而非SecretKey类型。

修正后的代码 #

1. 密钥生成与编码（原有代码可保留） #

KeyPair keyPair = Keys.keyPairFor(SignatureAlgorithm.RS256);

// 编码私钥（PKCS8格式）
PrivateKey aPrivate = keyPair.getPrivate();
String encodePrivate = Encoders.BASE64URL.encode(aPrivate.getEncoded());

// 编码公钥（X.509格式）
PublicKey aPublic = keyPair.getPublic();
String encodePublic = Encoders.BASE64URL.encode(aPublic.getEncoded());

2. 密钥解码与JWT处理（核心修正部分） #

import java.security.KeyFactory;
import java.security.spec.PKCS8EncodedKeySpec;
import java.security.spec.X509EncodedKeySpec;

// 解码私钥
byte[] privateKeyBytes = Decoders.BASE64URL.decode(encodePrivate);
PKCS8EncodedKeySpec privateKeySpec = new PKCS8EncodedKeySpec(privateKeyBytes);
KeyFactory keyFactory = KeyFactory.getInstance("RSA");
PrivateKey privateKey = keyFactory.generatePrivate(privateKeySpec);

// 解码公钥
byte[] publicKeyBytes = Decoders.BASE64URL.decode(encodePublic);
X509EncodedKeySpec publicKeySpec = new X509EncodedKeySpec(publicKeyBytes);
PublicKey publicKey = keyFactory.generatePublic(publicKeySpec);

// 生成JWT
String jwtStr = Jwts.builder()
     .setId(id)
     .setIssuedAt(now)
     .setSubject(subject)
     .setIssuer(issuer)
     .claim("dhdfh", "dfhd")
     .claim("cvbcv", "wrwerew")
     .signWith(privateKey, SignatureAlgorithm.RS256) // 显式指定RS256算法
     .compact();

// 验证JWT
Jwts.parserBuilder()
     .setSigningKey(publicKey)
     .build()
     .parseClaimsJws(jwtStr).getBody();

关键说明 #

• RSA私钥默认采用PKCS8格式编码，公钥采用X.509格式编码，解码时需对应使用PKCS8EncodedKeySpec和X509EncodedKeySpec。
• 生成JWT时显式指定SignatureAlgorithm.RS256，避免依赖默认算法匹配可能出现的问题。

内容的提问来源于stack exchange，提问作者failover