如何在NestJS中正确实现JWT Token过期时间续期？

错误原因 #

你遇到的Error: Bad "options.expiresIn" option the payload already has an "exp" property是因为jsonwebtoken库的限制：当签名新Token时，Payload中已存在exp字段的情况下，不能同时在options里设置expiresIn，两者会冲突，库无法确定使用哪个过期时间。

正确实现方案 #

下面提供两种可行的实现方式，核心是统一过期时间的设置方式，避免冲突，同时确保续期逻辑生效：

方式一：直接替换Payload中的exp字段 #

这种方式保留原Payload的所有业务字段，仅更新过期时间：

const jwt = require('jsonwebtoken');

function extendTokenExpiration(oldToken, secretKey) {
  // 1. 验证原Token有效性（自动检查是否过期，过期则抛出错误）
  const decodedPayload = jwt.verify(oldToken, secretKey);
  
  // 2. 计算新的过期时间：当前时间戳（秒）+ 60秒
  const newExpTime = Math.floor(Date.now() / 1000) + 60;
  
  // 3. 构建新Payload，替换原exp字段
  const newPayload = { ...decodedPayload, exp: newExpTime };
  
  // 4. 签名生成新Token（不设置expiresIn选项）
  return jwt.sign(newPayload, secretKey);
}

方式二：删除Payload中的exp，使用expiresIn选项 #

这种方式清除原Payload的过期字段，通过配置项设置新的过期时间：

const jwt = require('jsonwebtoken');

function extendTokenExpiration(oldToken, secretKey) {
  // 1. 验证原Token有效性
  const decodedPayload = jwt.verify(oldToken, secretKey);
  
  // 2. 移除原Payload中的exp字段
  const { exp, ...cleanPayload } = decodedPayload;
  
  // 3. 签名生成新Token，通过expiresIn设置60秒过期
  return jwt.sign(cleanPayload, secretKey, { expiresIn: '60s' });
}

你之前续期无效的可能原因 #

1. 未验证原Token有效性：如果用jwt.decode而非jwt.verify解码，原Token可能已过期，此时生成的新Token过期时间可能基于过去的时间点，导致立即失效。
2. 过期时间计算错误：若你是在原exp值基础上加60秒，而原exp已经是过去的时间，新Token的过期时间仍在过去，自然无效。正确的做法是基于当前时间计算新的过期时间。
3. 客户端未更新Token：生成新Token后，需确保客户端将旧Token替换为新Token（比如通过响应头、Cookie或返回体传递），否则后续请求仍使用旧Token，看起来续期未生效。

额外注意事项 #

• 续期逻辑仅应对未过期的Token执行，过期Token应要求用户重新登录，这也是用jwt.verify而非jwt.decode的原因。
• 若需限制Token的最大有效时长（比如2小时），可在生成初始Token时加入iat（签发时间）字段，续期时检查newExpTime是否超过iat + 7200（2小时），避免Token无限续期。

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