如何正确失效JWT实现登出功能？解决/profile报JWT未提供错误

JWT本身是无状态自包含的，无法直接在服务器端主动撤销已签发的令牌，需结合以下方式实现有效登出：

1. 客户端主动清除令牌 #

登出时，前端必须立即删除存储的JWT令牌（比如localStorage、sessionStorage或Cookie中），这样后续请求不会携带无效令牌，避免出现“JWT must be provided”这类错误。
示例前端代码：

// 移除localStorage中的令牌
localStorage.removeItem('token');
// 或清除Cookie
document.cookie = "token=; expires=Thu, 01 Jan 1970 00:00:00 UTC; path=/;";

2. 服务器端维护令牌黑名单 #

如果需要服务器端强制失效令牌（比如用户改密、异常登出），可以用Redis这类内存数据库维护令牌黑名单，设置过期时间与令牌有效期一致：

• 登出时，将当前令牌加入黑名单；
• 每次验证令牌前，先检查是否在黑名单内，若在则拒绝请求。
  示例Node.js+Redis代码：

// 登出接口逻辑
app.post('/logout', async (req, res) => {
  const token = req.headers.authorization?.split(' ')[1];
  if (token) {
    const decoded = jwt.verify(token, process.env.JWT_SECRET);
    // 按令牌剩余有效期设置黑名单过期时间
    await redis.setEx(`blacklist:${token}`, decoded.exp - Math.floor(Date.now()/1000), 'invalid');
  }
  res.status(200).json({ message: '登出成功' });
});

// 令牌验证中间件
const authenticateToken = async (req, res, next) => {
  const token = req.headers.authorization?.split(' ')[1];
  if (!token) return res.status(401).json({ error: 'JWT must be provided' });

  const isBlacklisted = await redis.exists(`blacklist:${token}`);
  if (isBlacklisted) return res.status(401).json({ error: '令牌已失效' });

  try {
    const user = jwt.verify(token, process.env.JWT_SECRET);
    req.user = user;
    next();
  } catch (err) {
    return res.status(403).json({ error: '令牌无效' });
  }
};

3. 短有效期令牌+刷新令牌机制 #

把访问令牌（Access Token）设为短有效期（如15分钟），同时签发有效期更长的刷新令牌（Refresh Token）：

• 登出时，前端清除访问令牌，服务器端将刷新令牌加入黑名单；
• 访问令牌过期后，前端用刷新令牌获取新的访问令牌，若刷新令牌失效则要求重新登录。

关于你遇到的报错分析 #

你操作后/profile接口抛出“JWT must be provided”，大概率是前端未正确清除令牌，或服务器端登出逻辑错误导致后续请求无有效令牌。建议先检查前端是否在登出后移除了令牌，再结合上述服务器端方案完善登出逻辑。

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