如何在keycloak.js中续期过期Access Token？续期报错求助

问题分析 #

你当前的问题主要来自两个关键点：

1. 调用时机错误：你是等Token完全过期后才调用updateToken(30)，但updateToken的参数minValidity是指「Token剩余有效期小于该值时触发刷新」。当Token已经过期（剩余有效期为0），即便满足刷新条件，若Refresh Token也已过期就会直接报错；即便Refresh Token有效，这种过期后再刷新的方式也不符合Keycloak JS的设计预期。
2. 错误处理语法错误：错误日志代码里多了一个多余的+号，导致JSON.stringify(error)的字符串被强制转换为数字，最终输出undefined，无法查看真实错误信息：

   console.error("Failed to refresh token : ", +JSON.stringify(error, null, 4));
   // 去掉+号才能正确输出错误内容
   

正确的Token续期实现方案 #

1. 修复错误处理代码 #

先修正错误日志的语法问题，确保能捕获真实错误信息：

console.error("Failed to refresh token : ", JSON.stringify(error, null, 4));

2. 调整Token检查逻辑（提前续期） #

不要等Token过期后再处理，而是提前检查剩余有效期，在Token快过期时就调用updateToken。同时处理updateToken的返回值，判断是否需要重新登录：

// 定时检查Token，建议间隔设为10-30秒（根据你的Token有效期调整）
export async function checkAndRenewToken() {
  try {
    // 检查Token剩余有效期是否小于30秒，而非是否已过期
    const shouldRenew = keycloak.isTokenExpired(30);

    if (shouldRenew) {
      console.log("Token即将过期，开始续期...");
      // updateToken返回布尔值：true表示Token被刷新，false表示无需刷新
      const refreshed = await keycloak.updateToken(30);
      
      if (refreshed) {
        console.log("Token续期成功");
      } else {
        console.log("Token仍有效，无需续期");
      }
    }
  } catch (error) {
    console.error("Token续期失败：", JSON.stringify(error, Object.getOwnPropertyNames(error)));
    // 续期失败说明Refresh Token也已过期，引导用户重新登录
    keycloak.login();
  }
}

3. 关键注意事项 #

• 定时任务间隔：建议将定时检查的间隔设置为minValidity的一半（比如设了30秒提前续期，就每15秒检查一次），避免错过续期时机。
• Refresh Token有效期：在Keycloak控制台确认客户端的Refresh Token有效期设置，确保它比Access Token有效期长（比如Access Token设60秒，Refresh Token至少设5分钟），否则会出现Access Token过期后Refresh Token也无法使用的情况。
• 避免重复调用：如果应用有多个地方调用续期方法，建议做防抖处理，避免同时发起多个刷新请求。

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