# 如何处理 Token 相关错误码? (/zh-CN/reference/faq/integration/token_related_issues) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). 当你的声网项目中启用了[主要/次要证书](/zh-CN/introduction/user-guides/manage-authentication#启用主要证书)且不允许仅 App ID 加入,则表示你选择使用动态密钥 Token 对用户进行鉴权。 由于 Token 具有一定的时效性,因此 App 在运行过程中,你有可能会收到如下与 Token 相关的错误码或事件回调。本文对这些事件进行了梳理,提供触发的原因以及解决方法,帮助你在 App 出现异常时进行问题排查。 :::info[信息] 本文适用于 RTC 产品。 ::: ## 101:App ID 无效 [#101app-id-无效] **问题描述:** Native 端:SDK 在初始化声网服务时返回错误码 `ERR_INVALID_APP_ID(101)`;或调用 `joinChannel` 方法加入频道时,SDK 回调 `onError` 事件,并报告错误码 `ERR_INVALID_APP_ID(101)`。 **问题原因:** 不是有效的 App ID,一般是由于 App ID 的数据类型不对引起的。 **解决方法:** 建议检查 App ID 数据格式是否有效。声网的 App ID 为 String 型,请使用正确数据类型的 App ID,重新初始化声网服务。 ## 109:Token 已过期 [#109token-已过期] **问题描述:** 调用 `joinChannel` 方法加入频道时,SDK 回调 `onError` 事件,并报告错误码 `ERR_TOKEN_EXPIRED(109)`。 **问题原因:** Token 过期。 **解决方法:** Token 一旦过期,你就需要在服务端重新生成一个 Token,然后调用 `renewToken` 方法尝试重新加入频道;在多频道场景下,你可以调用 `updateChannelMediaOptionsEx`(iOS 上为 `updateChannelExWithMediaOptions`)传入新的 Token。 ## 110:Token 无效 [#110token-无效] **问题描述:** 调用 `joinChannel` 方法加入频道时,SDK 回调 `onError` 事件,并报告错误码 `ERR_INVALID_TOKEN(110)`。 **问题原因:** 生成的 Token 无效。一般有以下原因: - 你的声网项目中启用了主要/次要证书且不允许仅 App ID 加入,但是加入频道时却未传入 Token;或者项目未开启主要/次要证书,就试图使用 Token 加入频道。 - 你在服务端生成 Token 时填入的 App ID、用户 ID 和频道名,与你初始化和加入频道时填入的 App ID、用户 ID 和频道名不匹配。 **解决方法:** - 在加入频道前,请确认你在初始化时填入的 App ID 对应的项目是否已启用主要/次要证书。 - 如果未启用主要/次要证书,则不能使用 Token 加入频道。 - 如果项目中已启用主要/次要证书且允许仅 App ID 加入,则既可以仅使用 App ID 加入频道,也可以使用主要/次要证书生成的 Token 加入频道。 - 如果项目中已启用主要/次要证书且不允许仅 App ID 加入,则必须使用 Token 加入频道。 - 当确认使用 Token 加入频道时,还需要确认: - 用于生成 Token 的 App ID 和初始化服务时填入的 App ID 一致。 - 用于生成 Token 的用户 ID 和加入频道时填入的用户 ID 一致,且数据类型也一致。 - 用于生成 Token 的频道名和加入频道时填入的频道名一致。 ## Token 过期相关事件回调 [#token-过期相关事件回调] 为保证通信体验,声网提供如下两个回调,提醒用户 Token 即将过期或已经过期: - `onTokenPrivilegeWillExpire`:该回调表示 Token 即将在 30 秒内失效。收到这个回调时,你需要在服务端重新生成 Token,然后调用 `renewToken` 方法,将新生成的 Token 传给 SDK。 - `onRequestToken`:该回调表示 Token 已经失效。收到这个回调时,你需要在服务端重新生成 Token,然后通过下列任意一种方式来更新 Token: - 单频道场景: - 调用 `renewToken` 来传入新的 Token。 - 调用 `leaveChannel` 来离开当前频道,然后再调用 `joinChannel` 并传入新的 Token 重新加入频道。 - 多频道场景:调用 `updateChannelMediaOptionsEx`(iOS 上为 `updateChannelExWithMediaOptions`) 传入新的 Token。 ## 各语言 Token 错误码对照表 [#各语言-token-错误码对照表] | 错误码 | Java/C++/C# | Objective-C | | ---------------- | ---------------- | ---------------- | | 101 | `ERR_INVALID_APP_ID` | `AgoraErrorCodeInvalidAppId` | | 109 | `ERR_TOKEN_EXPIRED` | `AgoraErrorCodeTokenExpired` | | 110 | `ERR_INVALID_TOKEN` | `AgoraErrorCodeInvalidToken` |