Java 1.8迁移至Java 17：JWT令牌生成与兼容验证问题

问题背景 #

正在将项目从Java 1.8迁移至Java 17，需要让Java 17版本的代码能够验证Java 1.8生成的现有JWT令牌，但当前新版代码无法兼容旧令牌，jwtSecret参数保持一致。

原有Java 1.8代码 #

令牌生成 #

public String generateId(String id) {
    return Jwts.builder().setSubject(id).setIssuedAt(new Date()).signWith(
                                    SignatureAlgorithm.HS512, jwtSecret)
                                                    .compact();
}

说明：id为数字字符串（如"12345"），jwtSecret为可能不足15字符的原始字符串。

令牌验证 #

try {
    Jwts.parser().setSigningKey(key).parseClaimsJws(authToken);
    return true;
}
// 省略异常处理逻辑

说明：key与jwtSecret为相同字符串，authToken为Java 1.8生成的令牌。

迁移到Java 17后的尝试代码 #

令牌生成 #

public String generateToken(String id) {
    Key key = Keys.hmacShaKeyFor(jwtSecret.getBytes(StandardCharsets.UTF_8));
    return Jwts.builder()
               .setSubject(id)
               .setIssuedAt(new Date())
               .signWith(key, SignatureAlgorithm.HS512)
               .compact();
}

令牌验证 #

public boolean validateToken(String authToken) {
    try {
        Key key = Keys.hmacShaKeyFor(jwtSecret.getBytes(StandardCharsets.UTF_8));
        Jwts.parser().setSigningKey(key).build().parseClaimsJws(authToken);
        return true;
    }
    // 省略异常处理逻辑
}

问题根源 #

旧版JJWT（Java 1.8使用版本）与新版JJWT的密钥处理逻辑存在差异：

• 旧版：直接将传入的字符串字节作为HMAC密钥使用，即使长度不符合HS512要求的64字节（512位），也不会做任何填充扩展。
• 新版：Keys.hmacShaKeyFor()方法会严格校验密钥长度，若传入字节数组长度不足，会自动通过重复填充扩展到符合要求的长度，导致新版生成的密钥与旧版实际使用的密钥不一致，无法验证旧令牌。

解决方案 #

要兼容旧令牌，必须让新版代码沿用旧版的密钥处理逻辑——直接使用jwtSecret的原始字节构造密钥，不做填充扩展：

兼容旧令牌的验证代码 #

public boolean validateToken(String authToken) {
    try {
        // 直接用原始字节构造SecretKey，完全匹配旧版逻辑
        SecretKey key = new SecretKeySpec(jwtSecret.getBytes(StandardCharsets.UTF_8), SignatureAlgorithm.HS512.getJcaName());
        Jwts.parser().setSigningKey(key).build().parseClaimsJws(authToken);
        return true;
    } catch (Exception e) {
        // 处理验证失败的异常场景
        return false;
    }
}

兼容旧版的令牌生成代码（可选） #

如果需要让新版生成的令牌也能被旧版代码验证，生成时同样使用原始字节构造密钥：

public String generateToken(String id) {
    SecretKey key = new SecretKeySpec(jwtSecret.getBytes(StandardCharsets.UTF_8), SignatureAlgorithm.HS512.getJcaName());
    return Jwts.builder()
               .setSubject(id)
               .setIssuedAt(new Date())
               .signWith(key, SignatureAlgorithm.HS512)
               .compact();
}

注意：HS512算法理论上要求密钥长度至少64字节，旧版使用短密钥的做法安全性较低。建议在兼容旧令牌的同时，逐步引导用户切换到符合安全标准的长密钥（≥64字节），并生成新令牌替换旧令牌。

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