使用agora-web-sdk-ng加入频道报CAN_NOT_GET_GATEWAY_SERVER无效token错误
Agora Web SDK NG 频道加入鉴权异常排查指南
核心报错特征
该错误AgoraRTCError CAN_NOT_GET_GATEWAY_SERVER: invalid token, authorized failed,附带返回{"retry":false},属于SDK请求网关鉴权环节的硬错误,不存在自动重试逻辑,问题根源在鉴权参数传递环节,与本地摄像头、麦克风采集流程无关。
高频触发原因与排查步骤
1. SDK版本与参数顺序不匹配(最高发踩坑点)
agora-web-sdk-ng 在4.11.0版本迭代时调整了核心API的入参规则,跨版本套用旧写法必然触发鉴权失败:
- 版本低于4.11.0时:
client.join()的入参顺序为join(appId, channel, token, uid),createClient初始化时不需要传入appId - 版本大于等于4.11.0时:appId需要在
createClient初始化时传入,client.join()的入参顺序调整为join(token, channel, uid)
如果安装的SDK版本≥4.11.0,代码仍沿用旧版写法把appId作为join的第一个参数传入,SDK会将第一个参数识别为待校验的token,拿appId字符串去做鉴权,自然会返回凭证无效的错误,与该报错的触发特征完全匹配。
2. Token 匹配度校验
参数顺序正确的前提下,逐维度核对Token的生成规则:
- Token生成时绑定的appId,必须和代码中使用的appId完全一致,大小写、首尾空格的差异都会导致校验失败
- Token生成时绑定的频道名,必须和代码中传入的频道名完全匹配,中文、特殊字符的转义差异也会触发鉴权拒绝
- 检查Token有效期:默认生成的Token有效期为24小时,超过时效的旧Token会被网关直接拒绝,且不会触发自动重试,和返回的
{"retry":false}特征一致
3. 项目鉴权配置核对
- 核对当前项目的鉴权开关:如果项目开启了「必须使用Token鉴权」,代码中传入null作为token时会被直接拒绝
- 如果项目未开启强制Token校验,传入格式错误的非合法Token值,也会触发该报错
快速验证流程
- 先核对项目中安装的agora-web-sdk-ng版本,按照对应版本的参数规则调整代码入参
- 临时将代码中的token替换为控制台生成的临时测试Token,严格按照参数顺序传入,验证是否可以正常加入频道
- 如果调整参数顺序后可以正常加入,说明之前的报错完全是参数传递错位导致的Token识别错误
修正后的代码参考(适配SDK版本≥4.11.0)
async startVideoStream() { // 初始化Client时传入appId,匹配新版SDK的参数规则 this.rtc.client = AgoraRTC.createClient({ mode: "live", codec: "h264", role: 'host', appId: this.options.appId }); // join 方法按新版顺序传入:token、频道名、uid(传null时由SDK自动分配uid) const uid = await this.rtc.client.join( this.options.token || null, this.options.channel, null ); this.rtc.localAudioTrack = await AgoraRTC.createMicrophoneAudioTrack(); this.rtc.localVideoTrack = await AgoraRTC.createCameraVideoTrack(); this.rtc.localVideoTrack.play('streamVideo') await this.rtc.client.publish([this.rtc.localAudioTrack, this.rtc.localVideoTrack]); }
内容的提问来源于stack exchange,提问作者Jorbari
相关产品推荐
相关产品推荐

