如何在io.jsonwebtoken:jjwt:0.12中正确指定密钥算法？

在JJWT 0.12.0及以上版本，io.jsonwebtoken.SignatureAlgorithm已被弃用，官方推荐使用Jwts.SIG替代。你遇到的UnsupportedKeyException是因为直接用Jwts.SIG.HS512.getId()返回的HS512作为SecretKeySpec的算法名称，而JCA标准要求的是HmacSHA512，名称不匹配导致异常。

正确实现方式 #

方式一：直接生成符合要求的密钥（推荐）

利用Jwts.SIG内置的密钥生成器，自动处理算法名称匹配和密钥长度要求：

// 生成HS512标准的密钥（自动满足512位长度要求）
SecretKey key = Jwts.SIG.HS512.key().build();

// 构建并签名JWT
String jwt = Jwts.builder()
        .signWith(key)
        .compact();

方式二：使用自定义密钥

如果需要使用自定义的密钥字节数组，必须确保长度至少为64字节（512位），并通过Jwts.SIG的密钥构建器生成密钥：

// 自定义密钥字节数组，长度需≥64字节
byte[] customKeyBytes = new byte[64];
// 用SecureRandom填充随机值，提升安全性
new SecureRandom().nextBytes(customKeyBytes);

// 通过Jwts.SIG的密钥构建器生成密钥，自动匹配JCA算法名称
SecretKey key = Jwts.SIG.HS512.key().build(customKeyBytes);

// 构建并签名JWT
String jwt = Jwts.builder()
        .signWith(key)
        .compact();

注意事项 #

• HS512算法要求密钥长度至少为512位（64字节），密钥长度不足会抛出WeakKeyException
• 避免手动使用SecretKeySpec指定算法名称，Jwts.SIG的密钥构建器会自动关联正确的JCA标准算法名称，从根源避免名称不匹配问题

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