本文介绍使用网易云信即时通讯 SDK（简称 NIM SDK）过程中出现的各类错误码及错误信息，您可以参考详细描述排查对应的问题。

通用状态码

code	desc	说明
0	unknown error	未知错误。
200	success	请求成功。

通用错误码

code	desc	说明
190001	internal error	内部错误。
190002	illegal state	非法状态。
191001	misuse	使用姿势错误。
191002	cancelled	操作取消。
191003	callback failed	回调失败。
191004	invalid parameter	参数错误。
191005	timeout	请求超时。
191006	resource not exist	资源不存在。
191007	resource already exist	资源已存在。

连接错误码

code	desc	说明
192001	connect failed	连接错误。
192002	connect timeout	连接超时。
192003	disconnected	连接断开。
192004	protocol timeout	协议超时。
192005	protocol send failed	协议发送失败。
192006	request failed	请求失败。

数据库错误码

code	message	详细描述。
193001	database open failed	数据库打开失败。
193002	database upgrade failed	数据库升级失败。
193003	database write failed	数据库写入失败。
193004	database read failed	数据库读取失败。

文件错误码

code	message	详细描述。
194001	file not found	文件找不到。
194002	file create failed	文件创建失败。
194003	file open failed	文件打开失败。
194004	file write failed	文件写入失败。
194005	file read failed	文件读取失败。
194006	file upload failed	文件上传失败。
194007	file download failed	文件下载失败。

应用错误码

code	desc	说明
101301	IM disabled	IM 未开通。请前往 网易云信控制台开通 IM 服务，开通步骤参考 开始使用 IM 产品。
101302	service address invalid	服务地址非法。
101303	appkey not exist	App Key 不存在。
101304	bundleid check failed	Bundle ID 校验失败。如果在 网易云信控制台 应用管理 > App Key 管理 > 标识管理 选中了进行标识安全验证，当客户端 app 标识(iOS Bundle Identifier / Android Package Name)不在配置的列表中，会返回该错误码。
101305	illegal auth type	非法的鉴权方式。

登录错误码

code	desc	说明
201	handshake error	握手错误。
202	asymmetric encryption algorithm error	非对称加密算法错误。
203	symmetric encryption algorithm error	对称加密算法错误。
204	handshake protocol version need fallback	握手协议版本需降级。
398	request temporary forbidden	请求被服务器暂时禁止。
399	server unit error	服务器单元错误。
403	forbidden	没有权限。
414	parameter error	参数错误。
416	rate limit exceeded	频率超限。
417	multi login forbidden	多端登录被禁止。
463	callback forbidden	第三方回调被拒绝。
500	internal server error	服务器内部错误。
503	server busy	服务器繁忙。
511	app server unreachable	app 服务不可达。
101301	IM disabled	IM 未开通。请前往 网易云信控制台开通 IM 服务，开通步骤参考 开始使用 IM 产品。
101302	service address invalid	服务地址非法。
101303	appkey not exist	App Key 不存在。
101304	bundleid check failed	Bundle ID 校验失败。如果在 网易云信控制台 应用管理 > App Key 管理 > 标识管理 选中了进行标识安全验证，当客户端 app 标识(iOS Bundle Identifier / Android Package Name)不在配置的列表中，会返回该错误码。
101305	illegal auth type	非法的鉴权方式。
102302	invalid token	无效 Token。
102303	robot not allowed	机器人账号不得登录。
102404	%s not exist	用户不存在。
102422	account banned	用户被禁用。

账号错误码

code	desc	说明
102404	account not exist	用户（网易云信 IM 账号）不存在。
102301	login record not found	找不到设备登录记录。
102302	invalid token	无效 Token。
102303	robot not allowed	机器人账号不得登录。
102422	account banned	用户被禁用。
102426	account in block list	用户被拉黑。
102421	account chat banned	用户被禁言。
102434	limit of accounts exceeded	超过最大用户数。
102449	account operation need retry	账号请求需要重试。
102405	account already exists	用户（网易云信 IM 账号）已存在。

会话错误码

code	desc	说明
110301	accounts for conversations not unique	会话所属账号（accountId）不唯一。
110302	conversation and account mismatch	会话和账号（accountId）不匹配。
110303	conversation stick top limit	会话置顶数量超限，默认支持 100 个会话上限。
110304	conversation belonged group limit	会话所属的会话分组数量超限，默认每个会话最多可属于 5 个分组。
110404	conversation not exist	该会话不存在。
110449	conversation operation need retry	会话请求需要重试。

AI 数字人错误码

code	desc	说明
102404	%s not exist	用户不存在。
189308	Failed request to the LLM	请求大语言模型失败。
189451	AI request hit antispam	AI 请求命中反垃圾。
107337	AI messages function disabled	AI 消息功能未开通。
102422	%s banned	用户被禁用。
102421	%s chat banned	用户被禁言。
104404	friend not exist	好友不存在。
107451	message hit antispam	消息命中反垃圾。
102304	It's not an AI account	不是数字人账号。
109404	team member not exist	群成员不存在。
108306	team normal member chat banned	群普通成员禁言。
109424	team member chat banned	群成员被禁言。
106403	You cannot blocklist an AI account	不允许对数字人进行黑名单操作。
416	rate limit exceeded	频率超限。
414	Parameter setting error: {name}	参数错误。

会话分组错误码

code	desc	说明
116404	conversation group not exist	该会话分组不存在。
116435	conversation group limit	会话分组数量超限。最多支持创建 50 个会话分组。
116437	conversations in group limit	会话分组中的会话数量超限。每个会话分组最多支持 1000 个会话。

用户资料错误码

code	desc	说明
103404	user profile not exist	用户资料不存在。
103451	user profile hit antispam	用户资料命中反垃圾。

好友错误码

code	desc	说明
104301	peer friend limit exceeded	对方好友数量超限。
103451	friend application not exist	好友申请不存在。
104404	friend not exist	好友不存在。
104405	friend already exist	好友已存在。
104429	self friend operation not allowed	不允许对自己进行好友操作。
104435	friend accounts limit exceeded	好友数量超限。
104449	friend operation rate limit exceeded	好友操作频率超限。
104451	friend hit antispam	好友操作命中反垃圾。

免打扰错误码

code	desc	说明
105435	mute list limit exceeded	免打扰用户列表超限。
105429	self mute operation not allowed	不允许在设置单聊消息免打扰时传入本人账号（accountId）。

黑名单错误码

code	desc	说明
106435	blocklist limit exceeded	黑名单用户数量超限。
106429	self blocklist operation not allowed	不允许将本人账号（accountId）加入黑名单。

消息错误码

code	desc	说明
107410	messaging function disabled	该 app 未开启发消息功能。
107451	message hit antispam	消息发送命中反垃圾。
107404	message not exist	消息不存在。
107429	revoke message to self not allowed	不允许撤回发给自己的消息。
107439	invalid time range	无效的时间范围。
107301	revoke third party message not allowed	不允许撤回第三方业务消息。
107302	sending message failed for marking message read failed for too many team members	由于群成员过多导致标记已读失败，消息发送失败。
107303	only sender or manager can revoke message	仅允许发送者或管理员撤回消息。
107304	rate limit of high-priority messages exceeded	高优消息发送超过频控限制。
107305	ack message should be high-priority	ACK 消息必须是高优消息。
107306	duplicate client message ID	消息客户端 ID 重复。
107307	short to long URL failed	短链转长链失败。
107308	URL invalid	无效 URL
107309	duration out of range	duration 超出范围。
107310	get file meta info failed	获取文件 meta 信息失败。
107311	audio file size limit exceeded	音频文件大小超限。
107312	voice to text timeout	语音转文字超时。
107313	voice to text failed	语音转文字失败。
107314	revoke message exceeded time limit	撤回消息超过时间限制。默认限制为 2 分钟，请前往 网易云信控制台 IM 即时通讯 > 基础功能 > 消息撤回时长 进行修改。
107315	revoke specified message not allowed	仅允许发送者或管理员撤回消息。
107316	force push list limit exceeded	群消息强推用户列表超过上限。
107317	team message receipt rate limit exceeded	群消息已读操作频率超限。
107318	snapshot not exist	快照不存在。
107319	PIN limit exceeded	PIN 消息数量超限。
107320	PIN not exist	PIN 消息不存在。
107321	quick comment limit exceeded	快捷评论数量超限。
107322	PIN already exist	PIN 消息已存在。
107323	rate limit for messaging exceeded	消息操作超过频控。
107325	read receipt for p2p messages function disabled	未开启单聊消息已读功能。请提交工单 联系网易云信技术支持工程师。
107326	quick comment function disabled	未开启快捷评论功能。请前往 网易云信控制台 IM 即时通讯 > 全局功能 > 消息快捷评论 进行开通。
107327	PIN function disabled	未开启消息 PIN 功能。请前往 网易云信控制台 IM 即时通讯 > 全局功能 > 会话消息标记 进行开通。
107328	delete self message not allowed	不允许删除发送给自己的消息。
107329	%s is not chatbot account	非机器人账号。
107330	sender or receiver must sense message	发送方和接收方必须有一方有感知。
107331	read receipt for team messages function disabled	未开启群消息已读功能。请前往 网易云信控制台 IM 即时通讯 > 群聊 > 群组已读 进行开通。
107332	read receipt record for the team message not found	群消息已读记录未找到。
107333	voice to text function disabled	语音转文字功能未开通。请前往 网易云信控制台 IM 即时通讯 > 全局功能 > 语音识别 进行开通。
107334	server search function disabled	云端搜索功能未开通。请前往 网易云信控制台 IM 即时通讯 > 全局功能 > 全文云端消息检索 进行开通。
107335	one-way delete function disabled	单向删除功能未开通。请前往 网易云信控制台 IM 即时通讯 > 全局功能 > 单向消息删除 进行开通。
107341	modify msg function disabled	更新消息功能未开通。
107342	modify msg type disabled	该消息类型不允许更新。
107343	modify msg param disabled	该消息参数不允许更新。
107344	not allowed to modify messages	不允许更新消息。
111301	resent message not exist	重发消息不存在。

群定向消息错误码

code	desc	说明
107338	One-way deletion is not allowed for target messages	定向消息不允许单向删除。
107339	The message sender cannot be included in the receiver_account_ids	定向列表不能包含消息发送者。
108318	Targeting messages for group chat is disabled	群定向消息功能未开启。
108319	Setting 'inclusive' to false for super teams is not allowed	超大群定向消息不支持反选。
108320	Cannot make super team targeted messages visible to new members	超大群定向消息不支持新成员可见。
108321	Cannot allow targeted messages inclusive to new members	定向消息成员正选不支持新成员可见。
109318	The forced push list includes non-targeted accounts	强推列表不能包含非定向成员。
107340	robot can not send target message	机器人消息不能是定向消息。
107345	pin target message is not allowed	不支持 PIN 定向消息。
107346	Target message not allowed reply	定向消息不支持回复。
107347	target message not allowed quick comment	定向消息不支持快捷评论。

群组错误码

code	desc	说明
108404	team not exist	该群组不存在。
108406	get online users count disabled	高级群获取在线人数功能未开启。请提交工单 联系网易云信技术支持工程师。
108423	all team members chat banned	群全体成员禁言。
108430	assign team owner manager role not allowed	不允许添加群主为管理员。
108434	extended super team limit	大容量超大群数量超限。默认为 20 个群，请前往 网易云信控制台 IM 即时通讯 > 群聊 > 超大群 进行修改。
108435	created team limit	创建的群组数量超过上限。默认为 100 个群/人，请前往 网易云信控制台 IM 即时通讯 > 群聊 > 创建群数量 进行修改。
108437	team invitation limit	群组内人数超过上限。高级群默认上限为 200，超大群默认上限为 2000，请前往 网易云信控制台 IM 即时通讯 > 群聊 > 群容量或超大群 进行修改。
108451	team hit antispam	群组命中反垃圾。
108449	team operation need retry	群组请求需要重试。
108302	not advanced team	非高级群。
108303	team manager limit exceeded	群组管理员数量超限。
108304	extended super team limit not configured	未配置大容量超大群的数量。
108305	joined team limit exceeded	加入群组数量超过上限。默认为 5000 群/人。
108306	team normal member chat banned	群全体普通成员禁言。
108307	invited account not friend	被邀请者非好友关系。
108308	reject all team applications	拒绝所有入群申请。
108309	create team with more than %s users not allowed	不允许创建超出 %s 人的群。
108310	operator is already team owner	当前操作者已是群主。
108311	super team service disabled	超大群服务未开通。请前往 网易云信控制台 IM 即时通讯 > 群聊 > 超大群 进行开通。
108313	create extended super team not allowed	不允许创建大容量超大群。
108314	team limit per query exceeded	查询群的数量超限。

群成员错误码

code	desc	说明
109301	list of chat banned users contains non team members	禁言列表包含非群成员。
109303	list of chat banned users contains the operator	禁言列表包含操作人。
109304	list of chat banned users contains the team owner	禁言列表包含群主。
109305	operation on team manager not allowed	不允许操作管理员。
109306	no team invite permission	没有群邀请权限。
109307	team owner quit not allowed	群主不允许退群。
109308	list of kicked user contains the team owner	群被踢列表包含群主。
109309	invite robot account not allowed	不允许邀请机器人账号进群。
109310	kick operator not allowed	被踢的群成员列表中包含操作者。
109311	team member already exist	群成员已存在。
109312	operation on self not allowed	不允许操作本人，
109313	team invitation or application not exist	群邀请或申请入群记录不存在。
109314	operation on team owner not allowed	不允许操作群主。
109404	team member not exist	群成员不存在。
109424	team member chat banned	群成员被禁言。
109427	team owner operation permission required	仅允许群主操作。
109432	team owner or manager operation permission required	仅允许群主或管理员操作。
109449	team member concurrent operation failed	并发操作群成员失败。
109451	team member hit antispam	群成员操作命中反垃圾。

广播通知错误码

code	desc	说明
111410	broadcasting notification service disabled	广播通知功能未开启。请前往 网易云信控制台 IM 即时通讯 > 全局功能 > 全员广播 进行开通。
111404	broadcasting notification not exist	该广播通知不存在。
111451	hit antispam	命中反垃圾。
113309	broadcasting notification hit antispam	广播通知命中反垃圾。
113310	broadcasting notification service disabled	广播通知服务未开启。

聊天室错误码

code	desc	说明
113304	failed to get chatroom link	获取有效的聊天室连接地址失败。
113305	IM connection abnormal	IM 连接状态异常。
113404	chatroom not exist	聊天室不存在。
113406	chatroom closed	聊天室已关闭。
113409	operation on chatroom repeated	聊天室重复操作。
113410	chatroom service disabled	聊天室服务未开通。请前往 网易云信控制台 IM 即时通讯 > 聊天室 进行开通。
113423	all chatroom members chat banned	聊天室全体成员禁言。
113451	chatroom info hit antispam	聊天室信息命中反垃圾。
113306	chatroom illegal auth type	非法的聊天室鉴权方式。
113307	identical field values	参数与现有聊天室属性一致，无需更新。
113428	chatroom manager operation permission required	仅允许聊天室管理员操作。
113434	chatroom count limit exceeded	聊天室数量超过限制。聊天室数量上限请前往 网易云信控制台 IM 即时通讯 > 聊天室 > 子功能配置 > 单用户可创建聊天室数 进行配置。
113308	notification for joining or leaving chatrooms disabled	聊天室成员进出通知功能未开启。请前往 网易云信控制台 IM 即时通讯 > 聊天室 > 子功能配置 > 聊天室用户进出消息系统下发 进行开通。
113301	chatroom temporarily chat banned	聊天室被临时禁言。
113302	chatroom tagged members chat banned	聊天室标签成员被禁言。
113303	chat room closing, reopen not allowed	聊天室关闭，不允许重新打开。

聊天室成员错误码

code	desc	说明
114404	chatroom member not exist	聊天室成员不存在。
114405	chatroom member repeated operation	聊天室成员重复操作。
114421	chatroom member chat banned	聊天室成员禁言。
114426	account in chatroom block list	账号在聊天室黑名单中。
114427	chatroom owner operation permission required	仅允许聊天室所有者操作。
114429	operator in chatroom member operation list	聊天室成员操作列表包含操作者。
114432	chatroom owner or manager operation permission required	仅允许聊天室所有者或管理员操作。
114437	chatroom member limit	聊天室成员数量超限。
114449	chatroom member concurrent operation failed	并发操作聊天室成员失败。
114451	chatroom member info hit antispam	聊天室成员命中反垃圾。
114408	Member: %s was already deleted	聊天室成员已删除。
114301	target account in blocklist or chat banned list of chatroom	目标账号在禁言或黑名单列表中。
114303	anonymous member operation forbidden	匿名成员禁止操作。
114304	Target chatroom member offline	目标成员账号不在线。

用户订阅错误码

code	desc	说明
119410	Subscription service disabled	订阅服务未开通。
119434	Subscription event limit reached	订阅事件超限。
119301	account ID list is not subscribed	账号列表均未订阅。
119302	Repeated subscription	重复订阅。
119303	Subscription failed	订阅失败。

反垃圾错误码

code	desc	说明
195001	client anti-spam	命中客户端反垃圾。
195002	server anti-spam	命中云端反垃圾。

全局错误码

code	desc	说明
201	handshake error	握手错误。
202	asymmetric encryption algorithm error	非对称加密算法错误。
203	symmetric encryption algorithm error	对称加密算法错误。
204	handshake protocol version need fallback	握手协议版本需降级。
398	request temporary forbidden	请求被服务器暂时禁止。
399	server unit error	服务器单元错误。
403	forbidden	没有权限。
404	not found	资源不存在。
414	parameter error	参数错误。
416	rate limit exceeded	频率超限。
417	multi login forbidden	多端登录被禁止。
449	need retry	请求需要重试。
463	callback forbidden	第三方回调被拒绝。
500	internal server error	服务器内部错误。
503	server busy	服务器繁忙。
511	app server unreachable	app 服务不可达。
514	service unavailable	服务不可用。
599	protocol filtered by blackhole rule	协议被黑洞规则过滤。
997	appid has no permission to call the protocol	appid 没有权限调用该协议。
998	unpack error	解包错误。
999	pack error	打包错误。

服务端错误码

code	desc	说明
403	request header for authentication missing	缺少鉴权请求头。
403	invalid AppKey	非法的 App Key
403	CurTime five minutes greater than server time	curtime 大于当前时间 5 分钟以上。
403	CurTime five minutes less than server time	curtime 小于当前时间 5 分钟以上。
403	authentication failed	checksum 鉴权失败。
403	access forbidden	拒绝访问。
400	incorrect request method	HTTP 请求方式错误。
414	invalid request body	请求体格式不正确。
414	invalid path or request parameter	路径参数或者请求参数不合法