JWT 告别废弃方法，升级依赖项指南

2024-03-07 21:01:13

## JWT 重焕新生：告别废弃方法

## JWT 的演变

JSON Web 令牌 (JWT) 在构建安全的 API 方面发挥着至关重要的作用，但在最近的版本中，java.util.Base64 类弃用给开发者带来了困扰。本指南将深入探讨此弃用的原因，并提供升级到最新 JWT 库版本的解决方案。

## 弃用背后的缘由

JWT 库最初依赖于 Java 7 中引入的 java.util.Base64 类，但在 Java 11 中它已被弃用。为了适应 Java 的发展，JWT 库更新为使用 Java 11 中引入的 java.util.Base64 实现。

## 解决方法：升级依赖项

要消除弃用警告，需要将 JWT 依赖项升级到至少 0.12.5 版本。此版本采用新的 java.util.Base64 实现，从而解决了弃用问题。

在 Maven 依赖项中更新 JWT 库的版本：

<dependency>
  <groupId>com.auth0</groupId>
  <artifactId>java-jwt</artifactId>
  <version>0.12.5</version>
</dependency>

## 示例代码重构

升级依赖项后，需要重写使用废弃方法的代码。以下示例展示了如何使用更新后的库重写创建 JWT 令牌的代码：

原代码：

private String createToken(Map<String, Object> claims, String subject) {
    return Jwts.builder()
            .setClaims(claims)
            .setSubject(subject)
            .setIssuedAt(new Date(System.currentTimeMillis()))
            // the token will be expired in 10 hours
            .setExpiration(new Date(System.currentTimeMillis() + 1000 * 60 * 60 * 10))
            .signWith(Algorithm.HMAC256(secret)) // Use SignatureAlgorithm
            .compact();
}

更新代码：

private String createToken(Map<String, Object> claims, String subject) {
    return Jwts.builder()
            .setClaims(claims)
            .setSubject(subject)
            .setIssuedAt(new Date(System.currentTimeMillis()))
            // the token will be expired in 10 hours
            .setExpiration(new Date(System.currentTimeMillis() + 1000 * 60 * 60 * 10))
            .signWith(Algorithm.HMAC256(secret)) // Use Algorithm class instead of SignatureAlgorithm
            .compact();
}