使用Agora Chat-SDK生成Token后多端客户端认证失败求助

以下是排查和解决该问题的几个关键点：

• 混淆Chat与实时音视频的App凭证
  Agora Chat有独立的App Key（对应代码中的appChatId）和App Certificate，需从控制台即时通讯服务模块获取，不要误用实时音视频服务的App ID和证书。

• User ID格式或一致性问题

  • Chat要求用户ID只能包含小写字母、数字、下划线、连字符，长度6-64字符，不符合规则会直接认证失败。
  • 客户端连接时使用的User ID必须与生成Token时传入的agoraUserId完全一致，大小写严格匹配。

• Token有效期设置异常

  • Chat Token最大有效期为2592000秒（30天），若tokenDurationInSecond设置为0、负数或超过最大值，都会导致Token无效。可临时设置3600秒测试，排除过期问题。

• App Certificate输入错误
  确认复制的是Chat模块的App Certificate，而非实时音视频的证书，检查是否存在多空格、字符缺失等输入错误。

• agora-token库版本或导入问题

  • 旧版本库可能存在Token生成逻辑偏差，执行npm update agora-token更新至最新版。
  • 确保正确导入ChatTokenBuilder：

    const { ChatTokenBuilder } = require('agora-token');
    

• 客户端连接参数错误

  • 客户端初始化Chat时需使用Chat的App Key，而非实时音视频的App ID。
  • 确认客户端获取的Token是完整字符串，无截断、额外引号或转义字符。

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