QQ机器人授权过程中常见的错误代码有哪些

---

---

在QQ机器人授权过程中，常见的错误代码及其含义如下：

HTTP状态码

401：认证失败。这通常意味着提供的认证信息（如Token）无效或已过期。

404：未找到API。这表示请求的API不存在或URL错误。

405：HTTP方法不允许。这意味着尝试使用了一个不被支持的HTTP方法来访问API。

429：频率限制。这表示请求频率超过了服务器允许的限制。

500：处理失败。这通常是一个服务器端的错误，表示服务器在处理请求时遇到了问题。

业务错误码

11241：ErrorWrongToken，参数中缺少Token。

11242：ErrorCheckTokenFailed，校验Token失败，系统错误，一般重试一次会好，最多只能重试一次。

11243：ErrorCheckTokenNotPass，校验Token未通过，用户填充的Token错误，需要开发者进行检查。

11251：ErrorWrongAppid，参数中的Appid错误，开发者填的Token错误，Appid无法识别。

11252：ErrorCheckAppPrivilegeFailed，检查应用权限失败，系统错误，一般重试一次会好，最多只能重试一次。

11253：ErrorCheckAppPrivilegeNotPass，检查应用权限不通过，该机器人应用未获得调用该接口的权限，需要向平台申请。

11254：ErrorInterfaceForbidden，应用接口被封禁，该机器人虽然获得了该接口权限，但是被封禁了。

11261：ErrorWrongAppid，参数中缺少Appid。

11262：ErrorCheckRobot，当前接口不支持使用机器人Bot Token调用。

11263：ErrorCheckGuildAuth，检查频道权限失败，系统错误，一般重试一次会好，最多只能重试一次。

11264：ErrorGuildAuthNotPass，检查小站权限未通过，管理员添加机器人的时候未授予该接口权限，属于逻辑错误，可提示用户进行授权，如果已经给予授权，请检查传递的guild id是否正确。

11265：ErrorRobotHasBaned，机器人已经被封禁。

11273：ErrorCheckUserAuth，检查用户权限失败，当前接口不支持使用Bearer Token调用。

11274：ErrorUserAuthNotPass，检查用户权限未通过，用户OAuth授权时未给与该接口权限，可提示用户重新进行授权。

11275：ErrorWrongAppid，无Appid。

11281：ErrorCheckAdminFailed，检查是否是管理员失败，系统错误，一般重试一次会好，最多只能重试一次。

11282：ErrorCheckAdminNotPass，检查是否是管理员未通过，该接口需要管理员权限，但是用户在添加机器人的时候并未授予该权限，属于逻辑错误，可以提示用户进行授权。

Mirai框架特有的错误码

45：表示登录时出现了安全异常，可能是由于登录设备异常、登录地点异常、账号被冻结等原因导致的。

WebSocket错误码

4001：无效的opcode。

4002：无效的payload。

4007：seq错误。

4006：无效的session id，无法继续resume，请identify。

4008：发送payload过快，请重新连接，并遵守连接后返回的频控信息。

4009：连接过期，请重连并执行resume进行重新连接。

4010：无效的shard。

4011：连接需要处理的guild过多，请进行合理的分片。

4012：无效的version。

4013：无效的intent。

4014：intent无权限。

4900~4913：内部错误，请重连。

4914：机器人已下架，只允许连接沙箱环境，请断开连接，检验当前连接环境。

4915：机器人已封禁，不允许连接，请断开连接，申请解封后再连接。

这些错误代码和对应的含义可以帮助开发者在授权过程中快速定位问题并采取相应的解决措施。

上一篇：QQ智能挂件如何与QQ云同步数据
下一篇：QQ机器人的授权限制有哪些

---