Spring Boot+Spring Security生成JWT遇HMAC密钥错误求助

问题回顾 #

我最近在Spring Boot项目里用Spring Security开发JWT认证功能，结果在Postman向/token接口发送POST请求（请求体为{ "userName": "RAM", "id":123, "role": "admin" }）时，收到了500错误，具体报错信息如下：

{ "timestamp": "2018-05-06T14:57:12.048+0000", "status": 500, "error": "Internal Server Error", "message": "Base64-encoded key bytes may only be specified for HMAC signatures. If using RSA or Elliptic Curve, use the signWith(SignatureAlgorithm, Key) method instead.", "path": "/token" }

问题原因 #

这个错误提示已经说得很明白了——你在生成JWT时，签名算法和密钥传递方式不匹配：

• 如果用的是HMAC系列对称加密算法（比如HS256、HS384、HS516），可以直接传入Base64编码的密钥字符串；
• 但如果用的是RSA/椭圆曲线这类非对称加密算法（比如RS256、RS384），就不能直接传密钥字符串，必须传入Key类型的密钥对象（私钥用于签名，公钥用于验证）。

解决方案 #

根据你使用的签名算法，对应调整代码即可：

情况1：使用RSA非对称算法

先加载你的RSA私钥（可以从本地文件或者配置中心读取），然后用私钥对象来签名JWT：

// 示例：从PEM文件加载RSA私钥
private PrivateKey loadRsaPrivateKey() throws Exception {
    String privateKeyContent = new String(Files.readAllBytes(Paths.get("private-key.pem")))
            .replace("-----BEGIN PRIVATE KEY-----", "")
            .replace("-----END PRIVATE KEY-----", "")
            .replaceAll("\\s", "");
    byte[] keyBytes = Base64.getDecoder().decode(privateKeyContent);
    PKCS8EncodedKeySpec spec = new PKCS8EncodedKeySpec(keyBytes);
    KeyFactory keyFactory = KeyFactory.getInstance("RSA");
    return keyFactory.generatePrivate(spec);
}

// 生成JWT的代码
String generateJwtToken(String username, Integer userId, String role) throws Exception {
    PrivateKey privateKey = loadRsaPrivateKey();
    return Jwts.builder()
            .setSubject(username)
            .claim("id", userId)
            .claim("role", role)
            .setExpiration(new Date(System.currentTimeMillis() + 3600000)) // 1小时过期
            .signWith(SignatureAlgorithm.RS256, privateKey)
            .compact();
}

情况2：使用HMAC对称算法

如果你本来就想用HMAC算法，确保签名算法和密钥传递方式匹配，直接传入Base64编码的密钥字符串即可：

// 注意密钥要足够长，比如HS256至少需要256位（32字节）的密钥
String hmacSecret = "your-strong-base64-encoded-secret-key-here";

String generateJwtToken(String username, Integer userId, String role) {
    return Jwts.builder()
            .setSubject(username)
            .claim("id", userId)
            .claim("role", role)
            .setExpiration(new Date(System.currentTimeMillis() + 3600000))
            .signWith(SignatureAlgorithm.HS256, hmacSecret)
            .compact();
}

额外注意

别忘了在验证JWT的时候，要和生成时的算法、密钥保持一致：

• RSA算法验证时用对应的公钥；
• HMAC算法验证时用同一个密钥字符串。

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