Agora Chat App临时令牌24小时过期后如何重新生成？自建服务器无效

令牌重新生成核心逻辑 #

临时Chat令牌的重新生成没有特殊流程，和首次生成逻辑完全一致：使用Agora控制台中Chat服务对应的App Key、App Secret，结合需要登录的用户ID，重新调用动态密钥生成算法即可生成新的有效令牌。默认有效期24小时，可通过生成时的参数自定义时长。

你使用的Node.js工具生成无效令牌的排查步骤 #

1. 凭证与参数匹配检查

   • 确认使用的App Key/Secret是Agora控制台中Chat服务的专属凭证，不要混用RTC、直播等其他服务的凭证
   • 生成令牌时传入的userUuid必须和客户端登录用的用户ID完全一致，大小写敏感
   • 检查expire参数（单位秒）是否正确设置，比如设为86400对应24小时有效期

2. 工具版本适配问题
   你使用的旧版DynamicKey工具可能未适配Chat最新的令牌生成规则，建议改用Agora官方维护的agora-token npm包，该包专门适配包括Chat在内的全产品线令牌生成。

3. 令牌格式验证
   有效Chat令牌格式为006${AppKey}${Signature}${UserUuid}${ExpireTime}${Salt}，可以将你生成的令牌和Agora控制台中生成的测试令牌对比格式是否一致，格式不符直接判定无效。

正确的令牌重新生成实现（基于官方npm包） #

1. 安装依赖：

   npm install agora-token
   

2. 生成/重新生成令牌的示例代码：

   const { ChatTokenBuilder } = require('agora-token');
   
   // 生成Chat令牌（首次/重新生成通用）
   function getChatToken(appKey, appSecret, userUuid, expireSeconds = 86400) {
     // 计算过期时间戳：当前时间+有效期秒数
     const expireTimestamp = Math.floor(Date.now() / 1000) + expireSeconds;
     // 调用官方工具生成令牌
     return ChatTokenBuilder.buildUserToken(appKey, appSecret, userUuid, expireTimestamp);
   }
   
   // 使用示例
   const appKey = "你的Chat App Key";
   const appSecret = "你的Chat App Secret";
   const targetUser = "客户端登录的用户ID";
   const newValidToken = getChatToken(appKey, appSecret, targetUser);
   console.log(newValidToken);
   

客户端令牌更新流程 #

在客户端集成SDK时，监听令牌过期相关事件（如onTokenWillExpire或onTokenExpired），触发事件时向你的服务器请求新令牌，调用SDK的renewToken方法完成更新，无需重新登录。

内容的提问来源于stack exchange，提问作者Billions.A.Joel