腾讯会议SaaS SDK登录报错问题排查方法
原创
在排查登录问题前需要先确保防火墙已经配置，并且用户已经创建成功，防火墙配置规则列表：防火墙配置腾讯会议域名和IP指引 - 腾讯会议帮助中心
腾讯会议登录报错常见的错误码如下：
名称 | 错误码 | 说明 | 回调函数 |
|---|---|---|---|
kTMSDKErrorInvalidAuthCode | -1002 | 无效AuthCode，登录参数不正确或IDaaS登录跳转存在问题 | onLogin() |
kTMSDKErrorUnknown | -1005 | 登录场景、投屏码投屏、屏幕共享状态获取等异常抛出未知错误，出现该错误码，请与官方联系 | onLogin()、onActionResult() |
kTMSDKErrorAccountAlreadyLogin | -1012 | 账号已登录，重复登录调用 | onLogin() |
kTMSDKErrorIsLogining | -1017 | 正在登录过程中的重复登录调用 | onLogin() |
kTMSDKErrorLoginNetError | -1018 | 登录过程出现网络错误 | onLogin() |
kTMSDKErrorTokenVerifyFailed | -1019 | sdktoken校验失败，可能是登录时sdktoken过期或使用时sdktoken失效，需要refreshSDKToken后再登录 | onResetSDKState()、onLogin() |
kTMSDKErrorMultiAccountLoginConflict | -1021 | A账户已登录，此时未调用logout()就登录B账户导致，如需切换账户，请先调用logout() | onLogin() |
上面和网络相关的错误码一般是-1002、-1005和-1018，非网络相关的有-1002、-1012、-1017、-1019和-1021
网络问题排查步骤（-1002、-1005、-1018）：
1、 报错回调的信息里面一般都会有URL和IP信息，需要在机器上的系统浏览器打开URL，并ping里面的IP，确认网络是否可达，如果不可达，需要客户网络同事确认请求出公网的路径存在的连通问题。都可达则进入下一步继续排查。
2、 使用telnet命令确认下面表中的URL及端口是否网络可达，示例如下：
URL | 端口 | 描述 |
|---|---|---|
conn.wemeet.tencent.com | TCP: 443 | 信令接入 |
XXXX.sso.meeting.qq.com | TCP: 80, 443 | sso登录 (根据企业SSO域名实际填写) |
XXXX.id.meeting.qq.com | TCP: 80, 443 | sso登录 (根据企业SSO域名实际填写) |
work.medialab.qq.com | TCP: 80, 443 | 接入类 |
quic.conn.wemeet.qq.com | UDP+TCP: 80, 443, 8080 | 信令接入 |
cdn.meeting.tencent.com | TCP: 80, 443 | 资源类 |
oth.eve.mdt.qq.com | TCP: 8081 | 代理 |
ten.sngapm.qq.com | TCP: 80, 443 | 安全 |
report.meeting.tencent.com | TCP: 80, 443 | 数据类 |
updatecdn.meeting.qq.com | TCP: 80, 443 | 下载更新 |
如果不可达，需要客户网络同事确认请求出公网的路径存在的联通问题。都可达则进入下一步继续排查。
3、 确认用户设备是否存在翻墙软件/代理软件，存在的话登录失败时间点附近是否存在开关代理/切换代理等行为，如果有的话需要退出SDK软件，待代理软件运行正常或者完全退出后（可以重启电脑尝试），再运行SDK，看是否恢复正常。
4、 如果以上方式都排查过，仍然无法确定原因，需要收集日志提交工单，寻求腾讯会议后台技术支持。由于部分网络问题出现后能自行恢复，这种情况对后台反馈日志定位结果的时效性要求比较高，需要在提单时备注说明清楚；在后台反馈报错原因后，需要将结果反馈给客户网络同事进行排查。常见情况的排查方式如下：
1）IP或者URL不通 - 定位设备到IP或者URL请求的记录，确认不可达的原因
2）IPV4/IPV6网络完全不通 - 是否存在对应用或者服务的网络访问限制
3）HTTPS证书被替换 - 根据后台提供的域名，确认证书被替换的原因，如果找不到，需要安全系统供应商介入排查
非网络问题排查方法
1、 -1002错误码
回调的报错内容里面有如下图的Token is expired字样，原因是ID Token过期了，需要使用在有效期内的ID Token进行登录
2、 -1012错误码
原因是当前SDK已经登录了，重复调用登录会报错，需要在登录代码里面增加判断SDK是否已登录的逻辑
3、 -1017错误码
原因是正在登录过程中的重复登录调用，在收到登录结果回调之前不要重复调用登录结果
4、 -1019错误码
原因是SDK Token已过期，需要向APP后台申请新的SDK Token，然后调用SDK的refreshSDKToken接口刷新，再调用登录接口重新登录
5、 -1021错误码
原因是切换SDK账号是没有先调用logout退出上一个账号，在切换账号时需要先调用logout接口，然后调用login接口登录新的账号
原创声明：本文系作者授权腾讯云开发者社区发表，未经许可，不得转载。
如有侵权，请联系 cloudcommunity@tencent.com 删除。
原创声明：本文系作者授权腾讯云开发者社区发表，未经许可，不得转载。
如有侵权，请联系 cloudcommunity@tencent.com 删除。
腾讯云开发者
