10/27/2025 18:02:31
解决方案
一、微信平台返回码
| 返回码 | 错误描述 | 推荐处理 |
|---|---|---|
| 0 | ok | - |
| -1 | 普通错误类型 | 查看返回的详细信息 |
| -2 | 用户点击取消并返回 | - |
| -3 | 发送失败 请重试 | - |
| -4 | 授权失败 请重试 | - |
| -5 | 微信不支持 | - |
| -6 | 应用签名不合法 | - |
| 26 | 用户拒绝授权登录 | - |
| 10026 | BundleID不正确 | 请使用和平台侧配置一致的 BundleID |
| 40001 | invalid credential | 重新拉起授权 |
| 40002 | invalid grant_type | 重新拉起授权 |
| 40003 | invalid openid | 确认 openid 准确性，若还有问题，联系 MSDK助手 反馈给微信侧处理 |
| 40007 | invalid media_id | 上传图片使用的 media_id 无效，重新上传图片获取media_id |
| 40008 | invalid message type | - |
| 40009 | invalid image size | 检查图片大小是否在要求范围内 |
| 40012 | invalid thumb size | 检查缩略图大小是否在要求范围内 |
| 40013 | invalid appid | 确认 appid 准确性，若还有问题，联系 MSDK助手 反馈给微信侧处理 |
| 40014 | invalid access_token | 确认 access_token 准确性，若还有问题，联系 MSDK助手 反馈给微信侧处理 |
| 40029 | invalid code | 重新拉起授权 |
| 40030 | invalid refresh_token | 重新拉起授权 |
| 40031 | invalid openid list | 重新拉起授权 |
| 40032 | invalid refresh_token | 重新拉起授权 |
| 40036 | invalid template_id size | - |
| 40037 | invalid template_id | - |
| 40039 | invalid url size | 检查 url 长度是否在要求范围内 |
| 40066 | invalid url | 检查 url 是否合法 |
| 40097 | invalid args | 接收方屏蔽了消息，让接收方查看一下微信：发现->游戏->我->隐私设置->游戏管理中查看“接收游戏消息”是否设置为关闭状态 |
| 40163 | code been used | 重新拉起授权 |
| 40180 | invalid client tmp token | 重新拉起授权 |
| 41001 | access_token missing | 重新拉起授权 |
| 41002 | appid missing | 确认请求参数 appid 准确性，若失败请联系 MSDK助手 提供技术支持 |
| 41003 | refresh_token missing | 确认请求参数 appid、refresh_token 准确性，若失败请联系 MSDK助手 提供技术支持 |
| 41004 | appsecret missing | 确认请求参数 appid、appkey 准确性，若失败请联系 MSDK助手 提供技术支持 |
| 41006 | media_id missing | 检查 media_id 参数是否传递 |
| 41008 | missing code | 确认请求参数 code 准确性，若失败请联系 MSDK助手 提供技术支持 |
| 41009 | missing openid | 确认请求参数 appid、openid 准确性，若失败请联系MSDK助手 提供技术支持 |
| 41010 | missing url | 检查 url 参数是否传递 |
| 42001 | access_token expired | accessToken 过期，刷新 token 或重新拉起授权 |
| 42003 | code expired | 重新拉起授权 |
| 42004 | refresh_token expired | 重新拉起授权 |
| 42009 | client tmp token expired | 重新拉起授权 |
| 43003 | require https | 使用 https 请求 |
| 43004 | require subscribe | - |
| 43005 | require friend relations | - |
| 44002 | empty post data | - |
| 45003 | title size out of limit | 检查 title 参数是否超过限制 |
| 45004 | description size out of limit | 检查 description 参数是否超过限制 |
| 45005 | url size out of limit | 检查 url 参数长度是否超过限制 |
| 45009 | api freq out of limit | 限制访问频率，检查是否受攻击，若失败请联系 MSDK助手 提供技术支持 |
| 45011 | api limit | 限制访问频率，检查是否受攻击，若失败请联系 MSDK助手 提供技术支持 |
| 45013 | too many template args | 限制访问频率，检查是否受攻击，若失败请联系 MSDK助手 提供技术支持 |
| 45014 | template message size out of limit | 限制访问频率，检查是否受攻击，若失败请联系 MSDK助手 提供技术支持 |
| 47001 | data format error | - |
| 48001 | api unauthorized | 重新拉起授权 |
二、微信群组功能返回码
| 返回码 | 错误描述 | 推荐处理 |
|---|---|---|
| -1 | 系统错误 | 重试一次，若失败请联系 MSDK助手 提供技术支持 |
| -10000 | 游戏没有在开平开通建群权限 | - |
| -10001 | 该游戏没有建群权限 | 游戏没有在游戏中心开通创建群的权限 |
| -10002 | 参数检查错误 | 确认参数准确性，若失败请联系 MSDK助手 提供技术支持 |
| -10003 | 链接不存在（与群无关） | - |
| -10004 | 获取跳转链接失败（与群无关） | - |
| -10005 | 群ID已存在 | 不要重复建群 |
| -10006 | 用户达到建群上限 | - |
| -10007 | 群ID不存在 | 换一个存在的群 ID |
| -10008 | 用户达到每天建群上限 | - |
| -10009 | 用户不在群里 | - |
| -10010 | 加群达到上限 | - |
| -20001 | 用户解绑群达到上限 | - |
| -20002 | 用户达到建群上限 | - |
| -20003 | group_id 已经创建过群（客户端接口） | - |
| -30001 | 加入的 group_id 不存在（客户端接口） | - |
| -201608 | kv读失败 | 联系微信相关接口人员 |
| -201609 | kv写失败 | 联系微信相关接口人员 |
Copyright © 2025 MSDK.
All rights reserved.
All rights reserved.