# 错误排查 (/zh-CN/realtime-media/rtm/build/troubleshooting/unity)
> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).
## 开启本地日志 [#开启本地日志-4]
当你的应用处于开发、测试阶段时,你可能需要 SDK 输出更详细的信息来定位并修复问题。你可以在初始化 RTM 实例的时候通过设置 `RtmConfig` 中的 `RtmLogConfig` 来开启日志输出并设置日志信息等级,之后即可在 IDE 中查看日志信息。
```csharp showLineNumbers
using Agora.Rtm;
private IRtmClient rtmClient;
LogConfig logConfig = new LogConfig()
// set log file path.
logConfig.filePath = "./logfile/";
// set log file size.
logConfig.fileSizeInKB = 512;
// set log report level.
logConfig.level = LOG_LEVEL.INFO;
RtmConfig config = new RtmConfig();
// initialize logconfig.
config.logConfig = logConfig;
config.appId = "your_appId";
config.userId = "your_userId";
try
{
rtmClient = RtmClient.CreateAgoraRtmClient(config);
Debug.Log("RTM Client Initialize Sucessfull");
}
catch (RTMException e)
{
Debug.Log(string.Format("{0} is failed.", e.Status.Operation ));
Debug.Log(string.Format("Error code: {0}, due to: {1}", e.Status.ErrorCode, e.Status.Reason));
}
```
`level` 字段可以设置为 `debug`、`info`、`warn`、`error`、`none` 五个等级之一,其中 `debug` 输出最详细的日志信息,`none` 不输出日志信息。
:::info[信息]
当你的应用上线时,请将日志信息等级设置为 `INFO`。
:::
## 错误码对照表 [#错误码对照表-4]
| 错误码 | 错误描述 | 原因及解决方法 |
| --- | --- | --- |
| `0` | `OK` | 正确调用。 |
| `-10001` | `NOT_INITIALIZED` | SDK 未初始化。请在调用 `CreateAgoraRtmClient` 方法初始化 RTM 实例后再执行其他操作。 |
| `-10002` | `NOT_LOGIN` | 用户未登录 RTM 系统、掉线超时或者主动退出登录后调用 API。请先登录 RTM 系统。 |
| `-10003` | `INVALID_APP_ID` | [error-codes-android-ios-swift-cpp-unity-harmonyos-html-0-4-2 details](#table-slot-error-codes-android-ios-swift-cpp-unity-harmonyos-html-0-4-2-3) |
| `-10005` | `INVALID_TOKEN` | 无效 Token。检查 Token Provider 是否生成 RTM Token。 |
| `-10006` | `INVALID_USER_ID` | [error-codes-android-ios-swift-cpp-unity-harmonyos-html-0-6-2 details](#table-slot-error-codes-android-ios-swift-cpp-unity-harmonyos-html-0-6-2-3) |
| `-10007` | `INIT_SERVICE_FAILED` | SDK 初始化失败。请重新调用 `CreateAgoraRtmClient` 方法进行初始化。 |
| `-10008` | `INVALID_CHANNEL_NAME` | [error-codes-android-ios-swift-cpp-unity-harmonyos-html-0-8-2 details](#table-slot-error-codes-android-ios-swift-cpp-unity-harmonyos-html-0-8-2-3) |
| `-10009` | `TOKEN_EXPIRED` | Token 过期失效。你需要调用 `renewToken` 重新获取 Token。 |
| `-10010` | `LOGIN_NO_SERVER_RESOURCES` | 服务器资源受限。建议重新登录。 |
| `-10011` | `LOGIN_TIMEOUT` | 登录超时。你需要检查当前网络是否稳定并切换到稳定网络环境中。如果你的网络处于内网环境,请检查你的防火墙是否配置了正确的域名和端口,详见[防火墙白名单设置](/zh-CN/realtime-media/rtm/build/rtm-initialization/application-setup#防火墙白名单设置)。 |
| `-10012` | `LOGIN_REJECTED` | [error-codes-android-ios-swift-cpp-unity-harmonyos-html-0-12-2 details](#table-slot-error-codes-android-ios-swift-cpp-unity-harmonyos-html-0-12-2-3) |
| `-10013` | `LOGIN_ABORTED` | [error-codes-android-ios-swift-cpp-unity-harmonyos-html-0-13-2 details](#table-slot-error-codes-android-ios-swift-cpp-unity-harmonyos-html-0-13-2-3) |
| `-10014` | `INVALID_PARAMETER` | 参数无效。检查你填写的参数是否正确。 |
| `-10015` | `LOGIN_NOT_AUTHORIZED` | 没有 RTM 服务权限。检查控制台是否开通 RTM 服务。 |
| `-10016` | `INCONSISTENT_APPID` | App ID 不一致。检查初始化、登录、加入频道的 App ID 是否一致。 |
| `-10017` | `DUPLICATE_OPERATION` | 重复操作。 |
| `-10018` | `INSTANCE_ALREADY_RELEASED` | 重复调用 `Dispose` 方法释放 `IRtmClient` 实例或重复调用 `Dispose` 释放 `IStreamChannel` 实例。 |
| `-10019` | `INVALID_CHANNEL_TYPE` | [error-codes-android-ios-swift-cpp-unity-harmonyos-html-0-19-2 details](#table-slot-error-codes-android-ios-swift-cpp-unity-harmonyos-html-0-19-2-3) |
| `-10020` | `INVALID_ENCRYPTION_PARAMETER` | [error-codes-android-ios-swift-cpp-unity-harmonyos-html-0-20-2 details](#table-slot-error-codes-android-ios-swift-cpp-unity-harmonyos-html-0-20-2-3) |
| `-10021` | `OPERATION_RATE_EXCEED_LIMITATION` | API 调用频率超过限制。各 API 的配额见[API 使用限制](/zh-CN/realtime-media/rtm/reference/usage-limits-and-errors/api-limits)。 |
| `-11001` | `CHANNEL_NOT_JOINED` | [error-codes-android-ios-swift-cpp-unity-harmonyos-html-0-22-2 details](#table-slot-error-codes-android-ios-swift-cpp-unity-harmonyos-html-0-22-2) |
| `-11002` | `CHANNEL_NOT_SUBSCRIBED` | [error-codes-android-ios-swift-cpp-unity-harmonyos-html-0-23-2 details](#table-slot-error-codes-android-ios-swift-cpp-unity-harmonyos-html-0-23-2-3) |
| `-11003` | `CHANNEL_EXCEED_TOPIC_USER_LIMITATION` | 订阅该 Topic 人数超出限制。 |
| `-11004` | `CHANNEL_IN_REUSE` | 共频道模式下,RTM 释放了 Stream Channel。 |
| `-11005` | `CHANNEL_INSTANCE_EXCEED_LIMITATION` | 创建的频道数量或订阅的频道数量超出限制。详见 [API 调用限制](/zh-CN/realtime-media/rtm/reference/usage-limits-and-errors/api-limits)。 |
| `-11006` | `CHANNEL_IN_ERROR_STATE` | 频道不可用。请重新创建 Stream Channel 或重新订阅 Message Channel。 |
| `-11007` | `CHANNEL_JOIN_FAILED` | [error-codes-android-ios-swift-cpp-unity-harmonyos-html-0-28-2 details](#table-slot-error-codes-android-ios-swift-cpp-unity-harmonyos-html-0-28-2-3) |
| `-11008` | `CHANNEL_INVALID_TOPIC_NAME` | [error-codes-android-ios-swift-cpp-unity-harmonyos-html-0-29-2 details](#table-slot-error-codes-android-ios-swift-cpp-unity-harmonyos-html-0-29-2) |
| `-11009` | `CHANNEL_INVALID_MESSAGE` | 无效消息。检查消息类型是否合法,RTM 只支持字符串或二进制类型消息。 |
| `-11010` | `CHANNEL_MESSAGE_LENGTH_EXCEED_LIMITATION` | [error-codes-android-ios-swift-cpp-unity-harmonyos-html-0-31-2 details](#table-slot-error-codes-android-ios-swift-cpp-unity-harmonyos-html-0-31-2) |
| `-11011` | `CHANNEL_INVALID_USER_LIST` | [error-codes-android-ios-swift-cpp-unity-harmonyos-html-0-32-2 details](#table-slot-error-codes-android-ios-swift-cpp-unity-harmonyos-html-0-32-2) |
| `-11012` | `CHANNEL_NOT_AVAILABLE` | Stream Channel 功能未开通,当前不可用。检查控制台是否已开启 Stream Channel 功能。 |
| `-11013` | `CHANNEL_TOPIC_NOT_SUBSCRIBED` | 未订阅该 Topic。 |
| `-11014` | `CHANNEL_EXCEED_TOPIC_LIMITATION` | Topic 数量超出限制。 |
| `-11015` | `CHANNEL_JOIN_TOPIC_FAILED` | 加入该 Topic 失败。检查已加入 Topic 数量是否超出限制。 |
| `-11016` | `CHANNEL_TOPIC_NOT_JOINED` | 未加入该 Topic。未加入 Topic 就发送消息,你需要先加入 Topic。 |
| `-11017` | `CHANNEL_TOPIC_NOT_EXIST` | 该 Topic 不存在。检查 Topic 名是否错误。 |
| `-11018` | `CHANNEL_INVALID_TOPIC_META` | Topic 中的 `meta` 参数无效。检查 `meta` 参数是否超出 256 字节的限制。 |
| `-11019` | `CHANNEL_SUBSCRIBE_TIMEOUT` | 频道订阅超时。检查连接是否断开。 |
| `-11020` | `CHANNEL_SUBSCRIBE_TOO_FREQUENT` | 频道订阅操作太频繁。请确保 5 秒内对同一频道的订阅操作不超过 2 次。 |
| `-11021` | `CHANNEL_SUBSCRIBE_FAILED` | 频道订阅失败。检查已订阅频道数量是否超出限制。 |
| `-11022` | `CHANNEL_UNSUBSCRIBE_FAILED` | 取消频道订阅失败。检查连接是否断开。 |
| `-11023` | `CHANNEL_ENCRYPT_MESSAGE_FAILED` | [error-codes-android-ios-swift-cpp-unity-harmonyos-html-0-44-2 details](#table-slot-error-codes-android-ios-swift-cpp-unity-harmonyos-html-0-44-2) |
| `-11024` | `CHANNEL_PUBLISH_MESSAGE_FAILED` | 消息发布失败。检查连接是否断开。 |
| `-11026` | `CHANNEL_PUBLISH_MESSAGE_TIMEOUT` | 消息发布超时。检查连接是否断开。 |
| `-11027` | `CHANNEL_NOT_CONNECTED` | SDK 与 RTM 服务器断开连接。请重新登录。 |
| `-11028` | `CHANNEL_LEAVE_FAILED` | 离开频道失败。检查连接是否断开。 |
| `-11029` | `CHANNEL_CUSTOM_TYPE_LENGTH_OVERFLOW` | Custom type 长度溢出。`customType` 字段长度需要在 32 个字符以内。 |
| `-11030` | `CHANNEL_INVALID_CUSTOM_TYPE` | `customType` 字段无效。检查 `customType` 字段是否包含非法字符。 |
| `-11031` | `CHANNEL_UNSUPPORTED_MESSAGE_TYPE` | 消息类型不支持。 |
| `-11032` | `CHANNEL_PRESENCE_NOT_READY` | Presence 服务未就绪。请重新加入 Stream Channel 或重新订阅 Message Channel。 |
| `-11033` | `CHANNEL_RECEIVER_OFFLINE` | [error-codes-android-ios-swift-cpp-unity-harmonyos-html-0-53-2 details](#table-slot-error-codes-android-ios-swift-cpp-unity-harmonyos-html-0-53-2) |
| `-12001` | `STORAGE_OPERATION_FAILED` | Storage 操作失败。 |
| `-12002` | `STORAGE_METADATA_ITEM_EXCEED_LIMITATION` | Storage Metadata Item 数量超出限制。 |
| `-12003` | `STORAGE_INVALID_METADATA_ITEM` | 无效 Metadata Item。 |
| `-12004` | `STORAGE_INVALID_ARGUMENT` | 无效参数。 |
| `-12005` | `STORAGE_INVALID_REVISION` | 无效 Revision 参数。 |
| `-12006` | `STORAGE_METADATA_LENGTH_OVERFLOW` | Metadata 长度溢出。 |
| `-12007` | `STORAGE_INVALID_LOCK_NAME` | 无效 Lock 名称。 |
| `-12008` | `STORAGE_LOCK_NOT_ACQUIRED` | 未获取该 Lock。 |
| `-12009` | `STORAGE_INVALID_KEY` | 无效 Metadata 键。 |
| `-12010` | `STORAGE_INVALID_VALUE` | 无效 Metadata 值。 |
| `-12011` | `STORAGE_KEY_LENGTH_OVERFLOW` | Metadata 键长度溢出。 |
| `-12012` | `STORAGE_VALUE_LENGTH_OVERFLOW` | Metadata 值长度溢出。 |
| `-12013` | `STORAGE_DUPLICATE_KEY` | 重复的 Metadata Item 键。 |
| `-12014` | `STORAGE_OUTDATED_REVISION` | Metadata Item 中的 Revision 过时或 Key 不存在。 |
| `-12015` | `STORAGE_NOT_SUBSCRIBE` | 未订阅该频道。 |
| `-12016` | `STORAGE_INVALID_METADATA_INSTANCE` | Metadata 实例不存在。请创建 Metadata 实例。 |
| `-12017` | `STORAGE_SUBSCRIBE_USER_EXCEED_LIMITATION` | 订阅用户 Metadata 数量超出限制。 |
| `-12018` | `STORAGE_OPERATION_TIMEOUT` | Storage 操作超时。 |
| `-12019` | `STORAGE_NOT_AVAILABLE` | Storage 服务不可用。 |
| `-13001` | `PRESENCE_NOT_CONNECTED` | 用户未连接到系统。 |
| `-13002` | `PRESENCE_NOT_WRITABLE` | Presence 服务不可用。 |
| `-13003` | `PRESENCE_INVALID_ARGUMENT` | 无效参数。 |
| `-13004` | `PRESENCE_CACHED_TOO_MANY_STATES` | 加入频道前缓存的临时用户状态超出限制。详见 [API 调用限制](/zh-CN/realtime-media/rtm/reference/usage-limits-and-errors/api-limits)。 |
| `-13005` | `PRESENCE_STATE_COUNT_OVERFLOW` | 临时用户状态键/值对数量超出限制。详见 [API 调用限制](/zh-CN/realtime-media/rtm/reference/usage-limits-and-errors/api-limits)。 |
| `-13006` | `PRESENCE_INVALID_STATE_KEY` | 无效状态键。 |
| `-13007` | `PRESENCE_INVALID_STATE_VALUE` | 无效状态值。 |
| `-13008` | `PRESENCE_STATE_KEY_SIZE_OVERFLOW` | 状态键长度溢出。 |
| `-13009` | `PRESENCE_STATE_VALUE_SIZE_OVERFLOW` | 状态值长度溢出 |
| `-13010` | `PRESENCE_STATE_DUPLICATE_KEY` | 重复的状态键。 |
| `-13011` | `PRESENCE_USER_NOT_EXIST` | 该用户不存在。 |
| `-13012` | `PRESENCE_OPERATION_TIMEOUT` | Presence 操作超时。 |
| `-13013` | `PRESENCE_OPERATION_FAILED` | Presence 操作失败。 |
| `-14001` | `LOCK_OPERATION_FAILED` | Lock 操作失败。 |
| `-14002` | `LOCK_OPERATION_TIMEOUT` | Lock 操作超时。 |
| `-14003` | `LOCK_OPERATION_PERFORMING` | Lock 操作进行中。 |
| `-14004` | `LOCK_ALREADY_EXIST` | Lock 已存在。 |
| `-14005` | `LOCK_INVALID_NAME` | 无效 Lock 名。 |
| `-14006` | `LOCK_NOT_ACQUIRED` | 未获取该 Lock。 |
| `-14007` | `LOCK_ACQUIRE_FAILED` | 获取该 Lock 失败。 |
| `-14008` | `LOCK_NOT_EXIST` | 该 Lock 不存在。 |
| `-14009` | `LOCK_NOT_AVAILABLE` | Lock 服务不可用。 |
**error-codes-android-ios-swift-cpp-unity-harmonyos-html-0-4-2 details**
无效 App ID:
- 检查 App ID 是否错误。
- 检查 App ID 是否开通了 RTM 服务。
**error-codes-android-ios-swift-cpp-unity-harmonyos-html-0-6-2 details**
无效用户 ID:
- 检查用户 ID 是否为空。
- 检查用户 ID 是否包含非法字符。
**error-codes-android-ios-swift-cpp-unity-harmonyos-html-0-8-2 details**
无效频道名称:
- 检查频道名是否为空。
- 检查频道名是否包含非法字符。
**error-codes-android-ios-swift-cpp-unity-harmonyos-html-0-12-2 details**
SDK 被服务器拒绝登录:
- 检查 App ID 是否开通 RTM 服务。
- 检查 Token 或 `userId` 是否被封禁。
**error-codes-android-ios-swift-cpp-unity-harmonyos-html-0-13-2 details**
由于未知问题 SDK 登录中断:
- 检查当前网络是否稳定,切换到稳定网络环境中。
- 当前 `userId` 在其他端登录。
**error-codes-android-ios-swift-cpp-unity-harmonyos-html-0-19-2 details**
频道类型无效。SDK 仅支持如下频道类型,请填写正确的值:
- `MESSAGE`: Message Channel
- `STREAM`: Stream Channel
**error-codes-android-ios-swift-cpp-unity-harmonyos-html-0-20-2 details**
消息加密参数无效。
- 检查生成的加密密钥是否为字符串类型。
- 检查生成的加密盐是否为字节数组类型,长度是否为 32 字节。
- 检查加密方式与加密密钥、加密盐是否匹配。
**error-codes-android-ios-swift-cpp-unity-harmonyos-html-0-22-2 details**
用户未加入该频道:
- 用户不在线、已离线或未加入该频道
- 检查 `userId` 是否拼写错误。
**error-codes-android-ios-swift-cpp-unity-harmonyos-html-0-23-2 details**
用户未订阅该频道:
- 用户不在线、已离线或未加入该频道
- 检查 `userId` 是否拼写错误。
**error-codes-android-ios-swift-cpp-unity-harmonyos-html-0-28-2 details**
加入该频道失败:
- 检查已加入频道数量是否超限。
- 检查频道名是否非法。
- 检查网络是否断开连接。
**error-codes-android-ios-swift-cpp-unity-harmonyos-html-0-29-2 details**
无效 Topic 名:
- 检查 Topic 名是否包含非法字符。
- 检查 Topic 名是否为空。
**error-codes-android-ios-swift-cpp-unity-harmonyos-html-0-31-2 details**
消息长度超出限制。检查消息负载大小是否超限:
- Message Channel 单个消息包小于 32 KB。
- Stream Channel 单个消息包小于 1 KB。
**error-codes-android-ios-swift-cpp-unity-harmonyos-html-0-32-2 details**
无效用户列表:
- 检查用户列表是否为空
- 检查用户列表是否包含非法项。
**error-codes-android-ios-swift-cpp-unity-harmonyos-html-0-44-2 details**
消息加密失败:
- 检查加密密钥是否有效。
- 检查加密盐是否有效。
- 检查加密方式与加密密钥、加密盐是否匹配。
**error-codes-android-ios-swift-cpp-unity-harmonyos-html-0-53-2 details**
发送用户消息时,远端用户不在线:
- 检查在调用方法时设置的用户 ID 是否正确。
- 检查远端用户是否登录系统并处于在线状态。
## 联系我们 [#联系我们-4]
如果以上措施都为未能解决你的故障,或者你需要解决方案的支持,请将你的需求整理出来并通过邮箱发送到:rtm-support@agora.io。我们会在收到邮件的第一时间与你取得联系。