12/12/2024 11:37:55
解决方案
一、QQ 平台返回码
| 错误码 | 错误说明 | 建议解决方案 |
|---|---|---|
| 1 | 未安装 QQ | 请先安装 QQ |
| 3 | 消息类型错误 | 请确认参数正确 |
| 4 | 消息内容为空 | 请确认参数正确 |
| 5 | 消息内容不合法 | 请确认参数正确 |
| 6 | App 未注册 | 请登录 QQ 开发者中心注册游戏 App |
| 10000 | qzone 分享不支持 text 类型分享 | 请确认使用正确 |
| -1 | client 的请求参数无效 | 检查请求参数准确性 |
| -2 | 请求中的 appid 不存在 | 确认 appid、appkey 的准确性，若失败请联系 MSDK助手 提供技术支持 |
| -3 | client 请求中 app 到 api 访问无权限 | 确认该 appid 是否有权限，如有权限的话请联系 MSDK助手 提供技术支持 |
| -4 | 请求中的 app ip 不允许 | 若失败请联系 MSDK助手 提供技术支持 |
| -5 | 签名验证失败 | 重试一次，若失败请联系 MSDK助手 提供技术支持 |
| -6 | client 请求中 app 到 api 访问超限 | 降低访问频率，检查是否正常请求，若失败请联系 MSDK助手 提供技术支持 |
| -7 | 请求协议非法 eg https 搞成了http | 确认访问协议是否正确，若失败请联系 MSDK助手 提供技术支持 |
| -8 | 请求受限,通常是安全审计没通过 | 若失败请联系 MSDK助手 提供技术支持 |
| -9 | api 不存在 | 若失败请联系 MSDK助手 提供技术支持 |
| -10 | 请求中的 app 内网 ip 不允许 | 若失败请联系 MSDK助手 提供技术支持 |
| -11 | 请求中的 app 外网 ip 不允许 | 若失败请联系 MSDK助手 提供技术支持 |
| -12 | 测试环境调试号码受限 | 请使用有权限的号码 |
| -20 | client 请求中 api 未经用户授权 | 重新授权 |
| -21 | access_token 已废除 | 重新授权 |
| -22 | openid 非法 | 确认 appid、openid 的准确性，若失败请联系 MSDK助手 提供技术支持 |
| -23 | openkey 非法 | 重新授权 |
| -24 | openid openkey 验证失败 | 重新授权 |
| -25 | 与系统当前时间相差超过10分钟 | 确认 appid、appkey、openkey 的一致性，若失败请联系 MSDK助手 提供技术支持 |
| -26 | 重复的 nonce | openid 转换时出错，确认 appid、openid 准确性 |
| -70 | 登录验证返回，验证 openkey 时 appid 非法 | 确认 appid、appkey、openkey 的一致性，若失败请联系 MSDK助手 提供技术支持 |
| -71 | openid 和 openkey 不匹配 | 确认 openid 与 openkey 的一致性 |
| -72 | appkey 和权限 tmem 中的 appkey 不一致 | 确认 appid、appkey 的准确性，若失败请联系 MSDK助手 提供技术支持 |
| -73 | 0x47 access token 改密失效 | 重新授权 |
| 100000 | 缺少或错误 response_type | 请检查请求参数 |
| 100001 | 缺少参数 client_id | 请检查请求参数 |
| 100002 | 缺少参数 client_secret | 请检查请求参数 |
| 100003 | http head 中缺少 Authorization | 请检查请求参数 |
| 100004 | 缺少或错误 grant_type | 请检查请求参数 |
| 100005 | 缺少 code 参数 | 请检查请求参数 |
| 100006 | 缺少 refresh token | 请检查请求参数 |
| 100007 | 缺少 access token | 请检查请求参数 |
| 100008 | 该 appid 不存在 | 确认 appid 的准确性，若失败请联系 MSDK助手 提供技术支持 |
| 100009 | appkey(client_secret) 不合法 | 确认 appid、appkey 的准确性，若失败请联系 MSDK助手 提供技术支持 |
| 100010 | 回调地址不合法 | 回调地址不合法，常见原因请联系 MSDK助手 提供技术支持 |
| 100011 | APP 不处于上线状态 | 若失败请联系 MSDK助手 提供技术支持 |
| 100012 | 非 post 方式 | 若失败请联系 MSDK助手 提供技术支持 |
| 100013 | access token 不合法 | 重新授权 |
| 100014 | access token 过期 | 重新授权 |
| 100015 | access token 废除 | 重新授权 |
| 100016 | access token 验证失败，其它原因 | 重新授权 |
| 220028 | 超出频率限制 | - |
| 251001 | 参数非法 | 按照参数列表检查参数是否正确 |
| 251002 | access token 不合法 | 重新授权 |
| 251003 | 获取好友 openid 失败 | 接口调用无权限，请申请权限 |
| 251004 | 获取好友缓存失败 | 反馈到 MSDK助手 联系手Q侧处理 |
| 251005 | 更新好友缓存失败 | 反馈到 MSDK助手 联系手Q侧处理 |
| 901203 | 基础侧限制发送频率：同一用户每天最多发送10条，每周最多发送40条 | 更换账号验证 |
| 901204 | 基础侧限制接收频率：同一用户每天最多能接收5条(最多从同一个用户每天接收1条)，同一用户每周最多接收20条 | 更换账号验证 |
| 901205 | 基础侧限制双方互动频率 ：用户之间每天最多互动一次 | 更换账号验证 |
| 9001010 | 应用/小程序不是上线状态 | 联系 qqconnecthelper 确认 |
| 225001 | appid不能为空 | |
| 225002 | openid不能为空 | |
| 225003 | fopenid不能为空 | |
| 225004 | accesstoken不能为空 | |
| 225005 | extraJSON 不能为空 | |
| 225006 | extraJSON 不符合要求 | 见msg解析 |
| 225007 | 校验好友关系失败 | |
| 225008 | 非好友关系不能发送消息 | |
| 225009 | appid+app+scene场景不存在，没有配置或配置没生效 | 绿洲配置需要约十分钟生效，若十分钟没生效请联系GameAccessHelper |
| 225010 | ark消息组包失败 | 请联系GameAccessHelper |
二、QQ 群组功能返回码
| 返回码 | 错误描述 | 推荐处理 |
|---|---|---|
| 221001 | 工会已有绑定群 | 更换群或者工会 |
| 221002 | 未绑定群 | 先进行绑群，再进行此操作 |
| 221003 | 绑群回包错误 | 联系手 Q 群 svr 同学处理 |
| 221004 | 获取 uin 和 tskey 失败 | 检查登录态是否正确 |
| 221005 | 当前用户不是群主 | 检查当前用户是否为群主 |
| 221006 | 无效的 openid | 检查 openid 是否有效 |
| 221007 | 传入参数不对 | 检查接口参数，如 appid,guild_id,zone_id,gc 等等，具体请参考接口参数列表 |
| 221008 | 无接口调用权限 | 参照权限管理申请权限 查看详情 |
| 221009 | 不是工会成员 | 检查玩家身份是否是工会成员 |
| 221010 | 达到创建群上限 | 联系手 Q 群 svr 同学处理 |
| 221011 | 创建群频率过高 | 联系手 Q 群 svr 同学处理 |
| 221012 | 群被删除了 | 联系手 Q 群 svr 同学处理 |
| 221013 | 群平台接口异常 | 联系手 Q 群 svr 同学处理 |
| 221014 | 读取存储失败 | 联系手 Q 群 svr 同学处理 |
| 221015 | 写入存储失败 | 联系手 Q 群 svr 同学处理 |
| 221016 | 发送公众号消息失败 | 联系手Q群svr同学处理 |
| 221017 | 数据上报失败 | 联系手Q群svr同学处理 |
| 221018 | 提醒绑群过于频繁 | 降低绑群接口访问频率 |
| 221019 | 群已经绑定了其他工会 | 更换群或者工会，再进行绑定 |
| 221020 | 群是收费群 | 更换绑定群为非收费群 |
| 221021 | 非游戏群 | 更换绑定群为游戏群 |
| -182001 | 请求群后台 cgi 失败 | 联系群平台同学处理 |
| -182002 | 操作 cmem 失败 | 联系手 Q 群 sv r同学处理 |
| -182003 | 创建群失败 | 联系群平台同学处理 |
| -182004 | 查询群失败 | 联系群平台同学处理 |
| -182005 | openid 转 uin 失败 | 联系群平台同学处理 |
| -182006 | 加群失败 | 联系群平台同学处理 |
| -182007 | 查询群列表失败 | 联系群平台同学处理 |
| -182008 | 查询 idip 失败 | 联系手 Q 群 svr 同学处理 |
| -500003~-500009 | 解析服务返回数据失败 | 联系手 Q 群 svr 同学处理 |
| -120000 | 登录态校验失败 | 检查登录态是否有效 |
三、QQ 游戏中心返回码
| 返回码 | 错误描述 | 推荐处理 |
|---|---|---|
| 0 | 成功 | - |
| -4000 | 创建处理逻辑失败 | 重试一次 |
| -4001 | 参数缺失 | 检查输入参数准确性，若失败请联系 MSDK助手 提供技术支持 |
| -4002 | 解析 sid 失败 | 重试一次 |
| -4003 | 写小红点时间戳失败 | 重试一次 |
| -4004 | 参数缺失 | 检查输入参数准确性，若失败请联系 MSDK助手 提供技术支持 |
| -4005 | servlet 服务没有创建处理逻辑 | 重试一次 |
| -4006 | 必须参数缺失 | 检查输入参数准确性，若失败请联系 MSDK助手 提供技术支持 |
| -4007 | 拉取应用好友失败 | 重试一次 |
| -4008 | 验证 AccessToken 失败 | 重试一次 |
| -4009 | 频率限制超过 | 降低频率，若失败请联系 MSDK助手 提供技术支持 |
| -4010 | 获取 UIN 错误 | 确认 appid、openid、accessToken 准确性，大部分原因是 accessToken 过期了，accessToken 是有有效期的，若失败请联系 MSDK助手 提供技术支持 |
| -4011 | 获取 open id 错误 | 确认 appid、openid准确性，若失败请联系 MSDK助手 提供技术支持 |
| -4012 | 上报成就数据过期，只有比原来数据大才可上报 | 过期时间戳无效 |
| -4013 | 效验 skey 失败 | 重新授权 |
| -4014 | 没有设置如何效验用户身份 | 重试一次，若失败请联系 MSDK助手 提供技术支持 |
| -4015 | 没有找到合适的 uri | 确认 appid、接口名称准确性，若失败请联系 MSDK助手 提供技术支持 |
| -4016 | 请求参数 sig 效验错误 | 重试一次，若失败请联系 MSDK助手 提供技术支持 |
| -4017 | openid 不存在 | 确认 appid、openid 准确性，若还有错误，联系 MSDK助手 反馈给游戏中心开发 |
| -4018 | 服务异常 | 重试一次，若失败请联系 MSDK助手 提供技术支持 |
| -4019 | 拉取成就数据失败 | 重试一次，若失败请联系 MSDK助手 提供技术支持 |
| -4020 | 发 feeds 失败 | 重试一次，若失败请联系 MSDK助手 提供技术支持 |
| -4021 | 获取个人信息失败 | 重试一次，若失败请联系 MSDK助手 提供技术支持 |
| -4022 | 参数不合法 | 重试一次，若失败请联系 MSDK助手 提供技术支持 |
| -4023 | 获取 feeds 失败 | 重试一次，若失败请联系 MSDK助手 提供技术支持 |
| -4024 | 没有最近玩的游戏 | 重试一次，若失败请联系 MSDK助手 提供技术支持 |
| -4025 | 获取最近玩的游戏失败 | 重试一次，若失败请联系 MSDK助手 提供技术支持 |
| -4026 | 应用在db里无配置 | 重试一次，若失败请联系 MSDK助手 提供技术支持 |
| -4027 | 拉取 feeds 失败 | 重试一次，若失败请联系 MSDK助手 提供技术支持 |
| -4028 | 解析 json 失败 | 重试一次，若失败请联系 MSDK助手 提供技术支持 |
| -4029 | 会员上报挑战开始信息失败 | 重试一次，若失败请联系 MSDK助手 提供技术支持 |
| -4030 | 游戏上报挑战开始信息失败 | 重试一次，若失败请联系 MSDK助手 提供技术支持 |
| -4031 | 时间戳非法,起始要小于结束 | 过期时间戳无效 |
| -4032 | appid 校验失败 | 确认 appid 准确性，若失败请联系 MSDK助手 提供技术支持 |
| -4033 | URL中无 param 字段或字段不合法 | 重试一次，若失败请联系 MSDK助手 提供技术支持 |
| -4034 | json 中无 list 字段或字段不合法 | 重试一次，若失败请联系 MSDK助手 提供技术支持 |
| -4035 | json 中无 type 或无 data 字段,或字段不合法(data 不能留空) | 确认请求参数 data 准确性，data 不能留空 |
| -4036 | uin 校验失败 | 确认 appid、openid 准确性，若失败请联系 MSDK助手 提供技术支持 |
| -4037 | expires 字段无效(是绝对过期时间戳,如1398575082) | 确认过期时间参数准确性 |
四、OIDB统一返回错误码
当 OIDB 返回错误时，需查看错误描述中的 ret，根据 ret 的值来确认 OIDB 具体的错误原因。例如：“msg”: “oidb decode0x73a failed, ret:17”，此时根据 ret:17 在下面表格中找到对应的原因。
4.1 OIDB统一返回错误码
| 十六进制 | 有符号十进制 | 无符号十进制 | 错误描述 |
|---|---|---|---|
| 0xff | -1 | 255 | 分两种情况: 1. OIDB寻址失败2. 后端认为uin为保留号码或者超过当前最大uin，也就是业务部门过来的uin并没有生成 |
| 0xfe | -2 | 254 | uin所在的db处于维护状态，暂时不能提供服务 |
| 0xfd | -3 | 253 | uin为互动号码，该命令不允许对互动号码操作 |
| 0x9b | -101 | 155 | 发送给后端Server失败(一般为IP/端口配置错误) |
| 0x9a | -102 | 154 | 表示该命令执行时间过长或者由于网络原因超时 |
| 0x99 | -103 | 153 | 接口调用已超过申请的频率上限, 请在单子中申请调整频率 |
| 0x98 | -104 | 152 | 测试系统没有用测试号码访问，请在这里自助添加测试号码http://oidb.server.com/#serviceGroup.selfServiceMainPanel或者在testuin.oa.com申请测试号码 |
| 0x97 | -105 | 151 | 登录态验证失败 |
| 0x96 | -106 | 150 | 业务没有申请权限，对照这里排查http://km.oa.com/group/oidb/articles/show/133650 |
| 0x95 | -107 | 149 | uin黑名单限制 |
| 0x94 | -108 | 148 | ip黑名单限制 |
| 0x93 | -109 | 147 | 请求包过大 |
| 0x92 | -110 | 146 | OPEN业务无权限, 请参考http://km.oa.com/group/oidb/articles/show/143284申请Open的访问权限 |
| 0x91 | -111 | 145 | 解包错误 |
| 0x70 | -144 | 112 | 后端系统回包: uin被冻结 |
| 0x71 | -143 | 113 | 后端系统回包: 员工账号保护系统号码 |
| 0x73 | -141 | 115 | 后端系统回包: 高级保护系统号码 |
| 0x71 | -140 | 116 | accesstoken非法，检查传入的accesstoken是否正确 |
| 0xc9 | -55 | 201 | 后端系统回包: 群server正在进行运维操作，限制机器为只读 |
| 0xca | -54 | 202 | 后端系统回包: 收到未知类型的包 |
| 0xcb | -53 | 203 | 后端系统回包: 请求包字段错误，比如群号填写超出了群server的服务范围 |
| 0xcc | -52 | 204 | 后端系统回包: 群被安全中心封停 |
| 0xec | -20 | 236 | 寻址后端Server失败(一般是命令字没有配置寻址方式) |
| 0xfb | -5 | 251 | 访问B类用户号码 |
| 0xfc | -4 | 252 | 访问BC类用户号码 |
| 0xcd | -51 | 205 | 测试环境访问频率超过限制值(请稍后再试) |
| 0xc1 | -63 | 193 | 命令未配置(一般是没有配置为ProtoBuf命令) |
| 0x5 | 5 | 5 | 命令未配置(一般是命令字没有配置到OIDB后台, 请自助配置:http://qq.server.com/oidb/addproto/) |
| 0xfa | -6 | 250 | 测试环境禁止访问该命令, 请申请正式环境的权限 |
| 0xf9 | -7 | 249 | 测试环境没有配置测试转包, 该命令不允许转抱到正式环境 |
4.2 手Q登录接口PayToken校验(0x73a)返回错误码
| 十六进制 | 有符号十进制 | 无符号十进制 | 错误描述 |
|---|---|---|---|
| 0x0 | 0 | 0 | 成功 |
| 0x10 | 16 | 16 | pay token失效(用户取消授权或过期被回收) |
| 0x11 | 17 | 17 | pay token已过期 |
| 0x12 | 18 | 18 | pay token已废除(生成新的paytoken会导致旧的废除) |
| 0x13 | 19 | 19 | appid与token不匹配 |
| 0x14 | 20 | 20 | openid长度不对(长度应该为16，二进制buffer格式) |
| 0x15 | 21 | 21 | openid非法 |
| 0x16 | 22 | 22 | openid被回收 |
| 0x17 | 23 | 23 | 验证openid返回其他失败(需要找负责人查具体原因) |
| 0x18 | 24 | 24 | openid与token不匹配 |
| 0x1b | 27 | 27 | appid非法 |
| 0x5e | 94 | 94 | pay token非法(解密失败) |
| 0x65 | 101 | 101 | 用户改密token失效 |
4.3 手Q登录接口accessToken校验(0x711)返回错误码
| 错误码 | 错误描述 |
|---|---|
| 0x00: | 成功 |
| 0x01: | 失败(系统内部错误) |
| 0x10~0x11: | Appid非法 |
| 0x12: | 读取第三方信息失败 |
| 0x13~0x14 | 系统内部错误 |
| 0x20 | openid非法 |
| 0x21 | openkey非法 |
| 0x22 | openid和openkey不匹配 |
| 0x23 | openkey已过期 |
| 0x24~0x25 | 系统内部错误 |
| 0x26 | 验证签名失败 |
| 0x27 | openid被回收 |
| 0x2a | 读udc失败(openid被回收或其他失败原因) |
| 0x2e | openid非法(开心id) |
| 0x32~0x36 | openid非法(业务类型127返回) |
| 0x37~0x38 | openid被回收(业务类型127返回) |
| 0x40 | access token无效 |
| 0x41 | access token已过期 |
| 0x42 | access token已废除 |
| 0x43 | access token冻结失效((1)用户取消授权导致；（2）用户改密或者封号导致token被废弃) |
| 0x44 | access token验证失败（若必现，请检查appid和access token是否对应） |
| 0x45 | access token与openid不匹配 |
| 0x46 | access token长度不对 |
| 0x47 | access token改密或封号导致失效 |
| 0x4a | 非法access token，解码失败（非手Q access token） |
| 0x4b | 读oin不存在（一般为号码被回收或者冻结导致） |
| 0x4c | 读u2o关系不存在（一般为号码被回收或者冻结导致） |
| 0x53 | openid被回收 |
| 0x54 | 转换的openid个数错误(业务类型23返回) |
| 0x55 | 所转换的openid非法(业务类型23返回) |
| 0x56 | 请求转换openid数量超过上限（500） |
| 0x58 | 无效appid(请求数据与后端数据不一致) |
| 0x60 | 未填写openid |
| 0x61 | 未填写openkey |
| 0x62 | 非法的业务类型 |
| 0x63 | 未填写appid |
Copyright © 2024 MSDK.
All rights reserved.
All rights reserved.