Spring Boot中使用JwtUtil类生成JWT令牌时出现空指针异常

常见原因及解决方法 #

• 核心签名参数未初始化
  生成JWT的签名密钥（SecretKey）为空是最常见诱因。比如通过@Value("${jwt.secret}")注入密钥时，配置文件未配置该属性、注入逻辑出错，导致密钥对象为null，调用签名方法时触发空指针。
  解决：检查配置文件中jwt.secret是否存在有效值，给JwtUtil的密钥字段添加非空校验：

  @Component
  public class JwtUtil {
      private final String secret;
  
      public JwtUtil(@Value("${jwt.secret}") String secret) {
          Assert.notNull(secret, "JWT签名密钥不能为空");
          this.secret = secret;
      }
      // 其他生成令牌的方法
  }
  

• 传入的用户信息为空
  调用生成令牌方法时，传入的用户对象（如UserDetails、用户ID）为null，或对象核心字段（如userId）为空，构建Claims时触发空指针。
  解决：调用generateToken前校验参数非空，确保核心字段有值：

  public String generateToken(User user) {
      Assert.notNull(user, "用户对象不能为空");
      Assert.notNull(user.getId(), "用户ID不能为空");
      // 构建Claims并生成令牌逻辑
  }
  

• 工具类未被Spring正确实例化
  若JwtUtil未添加@Component等Spring注解，调用时工具类对象为null；或依赖的JWT库（如jjwt）版本不兼容，内部方法调用触发空指针。
  解决：给JwtUtil添加@Component注解，确保被Spring容器管理；使用稳定兼容的JWT依赖版本，例如Maven依赖：

  <dependency>
      <groupId>io.jsonwebtoken</groupId>
      <artifactId>jjwt-api</artifactId>
      <version>0.11.5</version>
  </dependency>
  <dependency>
      <groupId>io.jsonwebtoken</groupId>
      <artifactId>jjwt-impl</artifactId>
      <version>0.11.5</version>
      <scope>runtime</scope>
  </dependency>
  <dependency>
      <groupId>io.jsonwebtoken</groupId>
      <artifactId>jjwt-jackson</artifactId>
      <version>0.11.5</version>
      <scope>runtime</scope>
  </dependency>
  

• Claims构建或签名算法异常
  指定的签名算法为null，或往Claims中存入的value为null且库不允许，都会触发空指针。
  解决：明确指定签名算法（如SignatureAlgorithm.HS256），构建Claims时校验所有键值对的value非空：

  Claims claims = Jwts.claims().setSubject(user.getUsername());
  claims.put("userId", user.getId()); // 确保user.getId()不为null
  String token = Jwts.builder()
          .setClaims(claims)
          .signWith(SignatureAlgorithm.HS256, secret)
          .compact();
  

注：附带的重复仪表盘文本及SQL查询语句与当前JWT空指针问题无关，推测为误粘贴内容。

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