NodeJS使用npm jsonwebtoken库无法获取预期详细错误信息的问题

嘿，我刚上手这个库的时候也踩过同样的坑！咱们一步步来解决：

首先，你之前用try/catch的方式没用，是因为jwt.verify的回调模式下不会抛出异常——错误只会通过回调的第一个参数err传递，所以你的try块里根本没捕获到错误，catch里的err自然是undefined。

然后，你看到的JsonWebTokenError: invalid token其实只是错误对象的字符串表现形式，它本身就是官方文档里说的结构化Error实例！你需要直接访问它的属性才能拿到详细信息。

正确的错误处理方式 #

直接在回调里访问err的专属属性，比如name、message、expiredAt（过期错误时才有）：

jwt.verify(token, "secret", (err, decode)=>{
  if(err){
    // 区分不同的错误类型
    switch(err.name) {
      case 'TokenExpiredError':
        console.log('Token已过期，过期时间:', err.expiredAt);
        console.log('错误信息:', err.message);
        break;
      case 'JsonWebTokenError':
        console.log('Token无效:', err.message);
        // 比如无效签名、格式错误等都属于这类
        break;
      case 'NotBeforeError':
        console.log('Token尚未生效:', err.message);
        // 如果你设置了nbf字段会触发这个错误
        break;
      default:
        console.log('其他认证错误:', err);
    }
    // 也可以直接打印整个错误对象的JSON结构，查看所有属性
    console.log('\n完整错误结构:', JSON.stringify(err, null, 2));
  }else{
    console.log('解码成功:', decode);
  }
})

为什么你之前看不到结构化信息？ #

当你直接console.log(err)时，JS默认会调用err.toString()，只输出错误类型和简单消息。但实际上：

• TokenExpiredError实例包含expiredAt属性（Date类型）
• JsonWebTokenError包含message说明具体无效原因（比如"invalid signature"、"invalid token"）
• 所有错误都有name属性用来区分类型

这样处理后，你就能完全拿到官方文档里描述的结构化错误信息啦！

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