RTC常见的错误码及对应解决方案_音视频通信(RTC)-阿里云帮助中心

通过阅读本文，您可以了解RTC常见的错误码及对应解决方案。

客户端错误码

十六进制	十进制	错误描述	原因分析	解决方案


十六进制	十进制	错误描述	原因分析	解决方案
0x01030101	16974081	invalid parameter	参数错误，AuthInfo中的字段为空或者timestamp<=0。	检查AuthInfo字段是否完整。
0x01030204	16974340	the operation is rejected in current state	状态错误，SDK内部状态错误。	销毁SDK重新创建实例。
0x01030304	16974596	publish stream is not exist	本地流（视频流、屏幕流、音频流）不存在。	调用publish重新进行推流。
0x01030305 0x01030308	16974597 16974600	publish stream has error	本地流（视频流、屏幕流、音频流）错误。	调用publish重新进行推流。
0x01030403	16974851	subscribe stream is not exist	远端流（视频流、屏幕流、音频流）不存在。	确认对方是否停止推流。
0x01030404 0x01030405	16974852 16974853	subscribe stream has error	远端流（视频流、屏幕流、音频流）错误。	确认对方是否停止推流。
0x01010103 0x0101010C 0x0101010D	16843011 16843020 16843021	sdk init error	初始化SDK异常。	检查SDK版本是否正确、JAR包是否缺失。
0x01020204	16908804	join timeout	加入频道超时。	检查网络连接是否正常。
0x0102020C	16908812	signal heartbeat is timeout	心跳包超时。	检查网络连接是否正常。
0x01020401	16909313	signal request is error	信令请求错误。	检查网络连接是否正常。
0x01020210 0x01020211 0x01020212 0x01020213 0x01020214 0x01020215 0x01020216 0x01020217 0x01020218	16908816 16908817 16908818 16908819 16908820 16908821 16908822 16908823 16908824	signal request is timeout	信令请求超时。	检查网络连接是否正常。
0x02010201	33620481	AppId is not exist	AppId不存在。	在控制台创建应用。
0x02010202	33620482	AppId is invalid	应用已经停用。	在控制台重新启用应用。
0x02010203	33620483	channel is invalid	加入频道失败：频道已经失效（目前频道有效期为48小时）。	重新生成频道鉴权令牌（Token）。
0x02010205	33620485	token is invalid	加入频道失败：Token无效。	重新生成频道鉴权令牌（Token）。
0x02010401	33620993	publish stream is abort	推流用户推流中断。	调用publish重新进行推流。
0x02010402	33620994	subscribe stream is abort	订阅用户订阅流中断。	确认对方是否停止推流。
0x02010403	33620995	failed to subscribe remote stream	订阅远端流失败：远端流已经停止发布。	无。
0x01040404	17040388	failed to open audio record device or audio device occupied	采集设备初始化失败、采集设备媒体服务异常、音频设备被占用。	Mac端和Windows端查看系统设置中音频设备是否有能量条；iOS端和Android端确认是否被其他应用占用；如果都正常，请重启设备。
0x01040405	17040389	failed to open audio play device or audio device occupied	播放设备初始化失败、播放设备媒体服务异常、音频设备被占用。	Mac端和Windows端查看系统设置中音频设备是否有能量条；iOS端和Android端确认是否被其他应用占用；如果都正常，请重启设备。
0x01040406	17040390	audio recording error or audio device occupied	系统性能不足、采集设备媒体服务异常、音频设备被占用。	重启应用或重启设备。
0x01040407	17040391	audio playing error or audio device occupied	系统性能不足，播放设备媒体服务异常，音频设备被占用。	重启应用或重启设备。
0x01040408	17040392	no audio recording permission	麦克风无权限。	去系统设置中，打开麦克风授权，并且重新加入频道。
0x01040409	17040393	no audio recording device found	麦克风设备异常。	检查是否接入了可用的麦克风，并检查系统设置中，该设备是否被禁用。
0x01040410	17040400	no audio play device found	播放设备异常。	检查是否接入了可用的扬声器或耳机，并检查系统设置中，该设备是否被禁用。
0x01040104	17039620	failed to open camera due to no permission or camera device occupied	相机打开失败、相机设备不可用、相机设备可能被占用。	检查系统相机是否可用，移动端App是否占用了相机。
0x01040106	17039622	camera capturing happens error	相机工作异常：Mac、Winodows电脑相机采集灯熄灭，设备被强制中断。	重新加入频道或者重启App。
0x01040201	17039873	failed to open render device	视频渲染启动失败。	检查Windows端显卡驱动是否需要升级，移动端手机型号或者Android平板盒子等外设是否支持OpenGL。
0x01040202	17039874	render happens error	视频渲染中发生异常：系统异常错误导致渲染引擎报错。	重新加入频道或者重启App。
0x01050201	17105409	failed to create media connection	媒体通道建立失败。	检查网络连接是否正常。
0x01050202	17105410	failed to reconnect media connection	媒体通道重连失败。	检查网络连接是否正常。
0x01060101	17170689	low performance happened	提示性能差。	关掉一些消耗CPU的处理，例如关闭美颜、关闭视频推流等。
0x01060102	17170690	performance restored	提示性能恢复，当前应用运行正常。	无。
0x02010105	33620229	session has been removed	Session会话已经被移除。	建议您：销毁实例之后重新创建实例并加入频道。
0x02010121	33620257	H5 is not compatible	客户端不兼容，未正确开启H5兼容模式。	重新检查H5兼容模式是否正确开启。
0x02010903	33622275	failed to join channel due to invalid channel profile	入会失败。	重新检查用户入会模式和其他用户的入会模式（频道模式）是否一致。
0x01010302	16843522	failed to leave channel due to already leaved	ERROR_ROOM_LEAVING_NOW，调用离开频道API时，当前用户已经在离会中了。	等离会任务结束后再进行其他操作。
0X01010304	16843524	operation failed dut to not in channel	ERROR_ROOM_NOT_IN_THE_CHANNEL，当前用户不在频道中。	请先入会，再执行其他推拉流相关的操作。
0x01010401 0x01010404	16843777 16843780	failed to publish due to already publishing	调用推流API时，当前用户当前已经在推流中了。	不要重复调用Publish，或者先停止推流再调用Publish。
0x01010402	16843778	operation failed dut to not in publishing	ERROR_PUBLISH_NOT_PUBLISHER，调用停止推流API时，当前用户并没有在推流。	不要重复调用停止推流的API。
0x01010405	16843781	publish config is invalid	ERROR_PUBLISH_CONFIG_IS_INVALID，Publish的配置错误。	检查Publish的配置信息。
0x01010501	16844033	subscribe config is invalid	ERROR_SUBSCRIBE_CONFIG_IS_INVALID，Subscribe的配置错误。	检查Subscribe的配置信息。
0x01020110	16908560	failed to update role	SOPHON_RESULT_UPDATE_ROLE_ERROR，更新角色失败。	请确认当前的channelProfile（频道类型），如果是Communication（通信）模式，无需设置ClientRole（角色类型）。更新角色需要在停止推流的时候。
0x01020201 0x01020202 0x01020203 0x01020205 0x01020206 0x01020207 0x01020208 0x01020209 0x0102020A 0x0102020B 0x0102020D 0x0102020E 0x0102020F 0x01020219 0x01020220 0x01020221 0x01020222	16908801 16908802 16908803 16908805 16908806 16908807 16908808 16908809 16908810 16908811 16908813 16908814 16908815 16908825 16908832 16908833 16908834	signal request is timeout	信令请求超时。	检查网络连接是否正常。
0x00000101	257	network weak	SDK_WARNING_NETWORK_WEAK，网络质量较差。	检查网络连接是否正常。
0x00000102	258	network recovered	SDK_WARNING_NETWORK_RECOVERY，网络质量恢复。	无。
0x00000103	259	network disconnected	SDK_WARNING_LOCAL_NETWORK_DISCONNECT，本地网络连接断开。	检查网络连接是否正常。
0x00000104	260	remote network disconnected	SDK_WARNING_REMOTE_NETWORK_DISCONNECT，远端用户网络连接断开。	无。
0x00000105	261	local network connected	SDK_WARNING_LOCAL_NETWORK_CONNECT，本地网络连接恢复。	无。
0x00000106	262	remote network connected	SDK_WARNING_REMOTE_NETWORK_CONNECT，远端用户网络连接恢复。	无。
0x01070101	17236225	external audio input buffer is full	SDK_AUDIO_INPUT_BUFFER_FULL，外部音频输入时，频次过快导致缓冲饱和。	降低外部输入频次。建议设置等待20ms，并且单次不超过40ms数据。
0x0103030d	16974605	failed to publish due to wrong role	SDK_RESULT_PUBLISH_WRONG_ROLE_ERROR，观众角色不能推流。	检查当前用户角色。
0x01090003	17367043	failed to open media file	打开文件失败。	请检查文件路径是否正确，文件是否具有可读权限。
0xFFFFFFFF	-1	WARN_DEFAULT	默认告警信息。	无。
0x02010101	33620225	session subscribe	客户端订阅对方时失败，可能原因：对方未推流或者停止推流。	确保对方推流期间调用订阅接口。

加入频道错误码

十六进制	十进制	错误描述	原因分析	解决方案


十六进制	十进制	错误描述	原因分析	解决方案
0x01010301	16843521	already joine	用户已经加入房间。	检查接口调用逻辑。
0x02010903	33622275	failed to join channel due to invalid channel profile	channel profile不匹配，如第一个人以通讯模式入会，之后如果有人已互动模式入会就会报此错。	重新检查用户入会模式和其他用户的入会模式（频道模式）是否一致。
0x05040002	84148226	channel is overdue	用户欠费了。用户的Token过期了，可以通过timestamp参数判断。 appid，appkey不对，或者不对应，一个appid对应唯一的一个appkey。用户的鉴权参数错误。	排查以下情况：确认账户余额是否充足。确认Token是否过期，可以通过timestamp参数判断，转成北京时间。第一种情况本身就是过期时间，第二种是本身+48小时是过期时间。 AppId和AppKey不匹配，一个AppId对应唯一的AppKey。确认鉴权参数是否正确。
0x02010702	33621762	join channel failed due to same user repeat join，please check if another device still in the channel	用户重复入会失败。如同一个用户，两个设备，进入同一个会。或者该用户上一个session还没有退会完成。	检查接口调用逻辑。
0x02010104	33620228	session join	客户端离开频道了之后又使用了相同的sessionId入会。	请尝试重新加入频道。
0x02010204	33620484	channel is not exist	加入频道失败，频道不存在。如会议发起者入会后又很快离会，第二个人随后入会，发现会议已经不存在了。	请尝试重新加入频道。
0x05010011	83951633	join channel failed due to invaild channel id	gslb请求ChannelId无效。如ChannelId不能带有空格。	检查channelId（频道ID）格式。频道ID支持1~64位，大小写字母、数字、下划线（_）、中划线（-）。
0x05010012	83951634	join channel failed due to invaild user id	gslb请求UserId无效。	请尝试重新加入频道。
0x0501001a	83951642	join channel due to invaild channel id	AppId配置了大方会模式，需要使用1.16.5以上的包入会，否则会入会失败。	检查SDK版本。
0x01020201	16908801	signal request is timeout	gslb请求长时间未收到，导致响应超时。	检查网络连接是否正常。
0x01020204	16908804	join timeout	入会请求长时间未收到，导致响应超时。	检查网络连接是否正常。
0x01030202	16974338	join error	加入房间错误。	检查鉴权信息是否正确以及网络环境是否正常。
0x01030201	16974337	gslb error	参数AuthInfo中的gslb字段错误。	检查AuthInfo中gslb字段是否完整，或验证AuthInfo是否可以通过校验。

旁路直播错误码

十六进制	十进制	错误描述	原因分析	解决方案


十六进制	十进制	错误描述	原因分析	解决方案
0x01100001	17825793	mpu task not found	MPU任务没有传入URL或停止已经停止的任务。	检查更新、停止MPU任务时传入的URL，或是否停止已经停止的任务。
0x01100002	17825794	mpu task already exist	启动已经启动的MPU任务。	检查是否在启动已经启动的MPU任务。
0x01100003	17825795	mpu task invalid param	传入无效的参数。	检查传入的参数是否合理或在有效范围内。
0x01100004	17825796	mpu task internal error	SDK内部错误，包括但不限于网络错误、服务端错误等。	尝试重新发起请求。
0x01100005	17825797	mpu task rtmp server error	服务端RTMP服务始化失败或资源下载失败。	检查MPU任务中资源链接的有效性（务必处理）。
0x01100006	17825798	mpu task rtmp stream error	服务端RTMP流错误。	检查RTMP流的URL格式是否正确有效（务必处理）。
0x01100007	17825799	mpu task publish timeout	服务端推流超时。	尝试重新发起请求（务必处理）。

跨频道推流错误码

十六进制	十进制	错误描述	原因分析	解决方案


十六进制	十进制	错误描述	原因分析	解决方案
0x01200001	18874369	channel relay state error	没有入会、角色错误或频道模式错误。	检查入会状态，确保当前为互动模式和主播角色。
0x01200002	18874370	channel relay src not allow	跨频道推流时频道模式错误。	切换频道模式为互动模式或低延迟互动直播模式。
0x01200003	18874371	channel relay join dest failed	跨频道推流时目标频道不存在或目标频道和源频道不是同一种频道模式。	检查跨频道时目标频道是否存在，确保目标频道和源频道模式一致（例如，都为互动模式）。
0x01200005	18874373	channel relay role error	跨频道推流的角色错误。	切换角色为主播角色。
0x01200006	18874374	channel realy invalid param	传入的参数不合法。	检查传入的参数是否合理或在有效范围内。
0x01200007	18874375	channel realy to self error	目标频道号和源频道号一致。	输入正确的目标频道号，不能和源频道号相同。

跨频道拉流错误码

十六进制	十进制	错误描述	原因分析	解决方案


十六进制	十进制	错误描述	原因分析	解决方案
0x01300001	19922945	channel relay sub request error	请求中的参数包含非法字符或格式。	检查请求参数格式的正确性和合法性。
0x01300002	19922946	channel relay sub request timeout	跨频道拉流请求超时。	尝试重新发送请求。
0x01300003	19922947	channel relay sub server timeout	没有在规定时间内创建目标频道，导致超时。	确保目标频道已经创建，尝试重新发送请求。