微信公众号全局返回码及其说明

喜欢ヅ旅行 2022-06-07 13:39 393阅读 0赞

最近经常要查阅公众号的错误返回码，为了方便，写下来方便以后查看：

相关的链接：[微信公众号官方文档][Link 1]

## 全局返回码说明 ##

公众号每次调用接口时，可能获得正确或错误的返回码，开发者可以根据返回码信息调试接口，排查错误。

**全局返回码说明如下：**

<table style="width:640px;"> 
 <tbody> 
 <tr> 
 <td style="background-color:#f7f7f7;"> 返回码 </td> 
 <td style="background-color:#f7f7f7;"> 说明 </td> 
 </tr> 
 <tr> 
 <td> -1 </td> 
 <td> 系统繁忙，此时请开发者稍候再试 </td> 
 </tr> 
 <tr> 
 <td> 0 </td> 
 <td> 请求成功 </td> 
 </tr> 
 <tr> 
 <td> 40001 </td> 
 <td> 获取access_token时AppSecret错误，或者access_token无效。请开发者认真比对AppSecret的正确性，或查看是否正在为恰当的公众号调用接口 </td> 
 </tr> 
 <tr> 
 <td> 40002 </td> 
 <td> 不合法的凭证类型 </td> 
 </tr> 
 <tr> 
 <td> 40003 </td> 
 <td> 不合法的OpenID，请开发者确认OpenID（该用户）是否已关注公众号，或是否是其他公众号的OpenID </td> 
 </tr> 
 <tr> 
 <td> 40004 </td> 
 <td> 不合法的媒体文件类型 </td> 
 </tr> 
 <tr> 
 <td> 40005 </td> 
 <td> 不合法的文件类型 </td> 
 </tr> 
 <tr> 
 <td> 40006 </td> 
 <td> 不合法的文件大小 </td> 
 </tr> 
 <tr> 
 <td> 40007 </td> 
 <td> 不合法的媒体文件id </td> 
 </tr> 
 <tr> 
 <td> 40008 </td> 
 <td> 不合法的消息类型 </td> 
 </tr> 
 <tr> 
 <td> 40009 </td> 
 <td> 不合法的图片文件大小 </td> 
 </tr> 
 <tr> 
 <td> 40010 </td> 
 <td> 不合法的语音文件大小 </td> 
 </tr> 
 <tr> 
 <td> 40011 </td> 
 <td> 不合法的视频文件大小 </td> 
 </tr> 
 <tr> 
 <td> 40012 </td> 
 <td> 不合法的缩略图文件大小 </td> 
 </tr> 
 <tr> 
 <td> 40013 </td> 
 <td> 不合法的AppID，请开发者检查AppID的正确性，避免异常字符，注意大小写 </td> 
 </tr> 
 <tr> 
 <td> 40014 </td> 
 <td> 不合法的access_token，请开发者认真比对access_token的有效性（如是否过期），或查看是否正在为恰当的公众号调用接口 </td> 
 </tr> 
 <tr> 
 <td> 40015 </td> 
 <td> 不合法的菜单类型 </td> 
 </tr> 
 <tr> 
 <td> 40016 </td> 
 <td> 不合法的按钮个数 </td> 
 </tr> 
 <tr> 
 <td> 40017 </td> 
 <td> 不合法的按钮个数 </td> 
 </tr> 
 <tr> 
 <td> 40018 </td> 
 <td> 不合法的按钮名字长度 </td> 
 </tr> 
 <tr> 
 <td> 40019 </td> 
 <td> 不合法的按钮KEY长度 </td> 
 </tr> 
 <tr> 
 <td> 40020 </td> 
 <td> 不合法的按钮URL长度 </td> 
 </tr> 
 <tr> 
 <td> 40021 </td> 
 <td> 不合法的菜单版本号 </td> 
 </tr> 
 <tr> 
 <td> 40022 </td> 
 <td> 不合法的子菜单级数 </td> 
 </tr> 
 <tr> 
 <td> 40023 </td> 
 <td> 不合法的子菜单按钮个数 </td> 
 </tr> 
 <tr> 
 <td> 40024 </td> 
 <td> 不合法的子菜单按钮类型 </td> 
 </tr> 
 <tr> 
 <td> 40025 </td> 
 <td> 不合法的子菜单按钮名字长度 </td> 
 </tr> 
 <tr> 
 <td> 40026 </td> 
 <td> 不合法的子菜单按钮KEY长度 </td> 
 </tr> 
 <tr> 
 <td> 40027 </td> 
 <td> 不合法的子菜单按钮URL长度 </td> 
 </tr> 
 <tr> 
 <td> 40028 </td> 
 <td> 不合法的自定义菜单使用用户 </td> 
 </tr> 
 <tr> 
 <td> 40029 </td> 
 <td> 不合法的oauth_code </td> 
 </tr> 
 <tr> 
 <td> 40030 </td> 
 <td> 不合法的refresh_token </td> 
 </tr> 
 <tr> 
 <td> 40031 </td> 
 <td> 不合法的openid列表 </td> 
 </tr> 
 <tr> 
 <td> 40032 </td> 
 <td> 不合法的openid列表长度 </td> 
 </tr> 
 <tr> 
 <td> 40033 </td> 
 <td> 不合法的请求字符，不能包含\uxxxx格式的字符 </td> 
 </tr> 
 <tr> 
 <td> 40035 </td> 
 <td> 不合法的参数 </td> 
 </tr> 
 <tr> 
 <td> 40038 </td> 
 <td> 不合法的请求格式 </td> 
 </tr> 
 <tr> 
 <td> 40039 </td> 
 <td> 不合法的URL长度 </td> 
 </tr> 
 <tr> 
 <td> 40050 </td> 
 <td> 不合法的分组id </td> 
 </tr> 
 <tr> 
 <td> 40051 </td> 
 <td> 分组名字不合法 </td> 
 </tr> 
 <tr> 
 <td> 40060 </td> 
 <td> 删除单篇图文时，指定的 article_idx 不合法 </td> 
 </tr> 
 <tr> 
 <td> 40117 </td> 
 <td> 分组名字不合法 </td> 
 </tr> 
 <tr> 
 <td> 40118 </td> 
 <td> media_id大小不合法 </td> 
 </tr> 
 <tr> 
 <td> 40119 </td> 
 <td> button类型错误 </td> 
 </tr> 
 <tr> 
 <td> 40120 </td> 
 <td> button类型错误 </td> 
 </tr> 
 <tr> 
 <td> 40121 </td> 
 <td> 不合法的media_id类型 </td> 
 </tr> 
 <tr> 
 <td> 40132 </td> 
 <td> 微信号不合法 </td> 
 </tr> 
 <tr> 
 <td> 40137 </td> 
 <td> 不支持的图片格式 </td> 
 </tr> 
 <tr> 
 <td> 40155 </td> 
 <td> 请勿添加其他公众号的主页链接 </td> 
 </tr> 
 <tr> 
 <td> 41001 </td> 
 <td> 缺少access_token参数 </td> 
 </tr> 
 <tr> 
 <td> 41002 </td> 
 <td> 缺少appid参数 </td> 
 </tr> 
 <tr> 
 <td> 41003 </td> 
 <td> 缺少refresh_token参数 </td> 
 </tr> 
 <tr> 
 <td> 41004 </td> 
 <td> 缺少secret参数 </td> 
 </tr> 
 <tr> 
 <td> 41005 </td> 
 <td> 缺少多媒体文件数据 </td> 
 </tr> 
 <tr> 
 <td> 41006 </td> 
 <td> 缺少media_id参数 </td> 
 </tr> 
 <tr> 
 <td> 41007 </td> 
 <td> 缺少子菜单数据 </td> 
 </tr> 
 <tr> 
 <td> 41008 </td> 
 <td> 缺少oauth code </td> 
 </tr> 
 <tr> 
 <td> 41009 </td> 
 <td> 缺少openid </td> 
 </tr> 
 <tr> 
 <td> 42001 </td> 
 <td> access_token超时，请检查access_token的有效期，请参考基础支持-获取access_token中，对access_token的详细机制说明 </td> 
 </tr> 
 <tr> 
 <td> 42002 </td> 
 <td> refresh_token超时 </td> 
 </tr> 
 <tr> 
 <td> 42003 </td> 
 <td> oauth_code超时 </td> 
 </tr> 
 <tr> 
 <td> 42007 </td> 
 <td> 用户修改微信密码，accesstoken和refreshtoken失效，需要重新授权 </td> 
 </tr> 
 <tr> 
 <td> 43001 </td> 
 <td> 需要GET请求 </td> 
 </tr> 
 <tr> 
 <td> 43002 </td> 
 <td> 需要POST请求 </td> 
 </tr> 
 <tr> 
 <td> 43003 </td> 
 <td> 需要HTTPS请求 </td> 
 </tr> 
 <tr> 
 <td> 43004 </td> 
 <td> 需要接收者关注 </td> 
 </tr> 
 <tr> 
 <td> 43005 </td> 
 <td> 需要好友关系 </td> 
 </tr> 
 <tr> 
 <td> 43019 </td> 
 <td> 需要将接收者从黑名单中移除 </td> 
 </tr> 
 <tr> 
 <td> 44001 </td> 
 <td> 多媒体文件为空 </td> 
 </tr> 
 <tr> 
 <td> 44002 </td> 
 <td> POST的数据包为空 </td> 
 </tr> 
 <tr> 
 <td> 44003 </td> 
 <td> 图文消息内容为空 </td> 
 </tr> 
 <tr> 
 <td> 44004 </td> 
 <td> 文本消息内容为空 </td> 
 </tr> 
 <tr> 
 <td> 45001 </td> 
 <td> 多媒体文件大小超过限制 </td> 
 </tr> 
 <tr> 
 <td> 45002 </td> 
 <td> 消息内容超过限制 </td> 
 </tr> 
 <tr> 
 <td> 45003 </td> 
 <td> 标题字段超过限制 </td> 
 </tr> 
 <tr> 
 <td> 45004 </td> 
 <td> 描述字段超过限制 </td> 
 </tr> 
 <tr> 
 <td> 45005 </td> 
 <td> 链接字段超过限制 </td> 
 </tr> 
 <tr> 
 <td> 45006 </td> 
 <td> 图片链接字段超过限制 </td> 
 </tr> 
 <tr> 
 <td> 45007 </td> 
 <td> 语音播放时间超过限制 </td> 
 </tr> 
 <tr> 
 <td> 45008 </td> 
 <td> 图文消息超过限制 </td> 
 </tr> 
 <tr> 
 <td> 45009 </td> 
 <td> 接口调用超过限制 </td> 
 </tr> 
 <tr> 
 <td> 45010 </td> 
 <td> 创建菜单个数超过限制 </td> 
 </tr> 
 <tr> 
 <td> 45011 </td> 
 <td> API调用太频繁，请稍候再试 </td> 
 </tr> 
 <tr> 
 <td> 45015 </td> 
 <td> 回复时间超过限制 </td> 
 </tr> 
 <tr> 
 <td> 45016 </td> 
 <td> 系统分组，不允许修改 </td> 
 </tr> 
 <tr> 
 <td> 45017 </td> 
 <td> 分组名字过长 </td> 
 </tr> 
 <tr> 
 <td> 45018 </td> 
 <td> 分组数量超过上限 </td> 
 </tr> 
 <tr> 
 <td> 45047 </td> 
 <td> 客服接口下行条数超过上限 </td> 
 </tr> 
 <tr> 
 <td> 46001 </td> 
 <td> 不存在媒体数据 </td> 
 </tr> 
 <tr> 
 <td> 46002 </td> 
 <td> 不存在的菜单版本 </td> 
 </tr> 
 <tr> 
 <td> 46003 </td> 
 <td> 不存在的菜单数据 </td> 
 </tr> 
 <tr> 
 <td> 46004 </td> 
 <td> 不存在的用户 </td> 
 </tr> 
 <tr> 
 <td> 47001 </td> 
 <td> 解析JSON/XML内容错误 </td> 
 </tr> 
 <tr> 
 <td> 48001 </td> 
 <td> api功能未授权，请确认公众号已获得该接口，可以在公众平台官网-开发者中心页中查看接口权限 </td> 
 </tr> 
 <tr> 
 <td> 48002 </td> 
 <td> 粉丝拒收消息（粉丝在公众号选项中，关闭了“接收消息”） </td> 
 </tr> 
 <tr> 
 <td> 48004 </td> 
 <td> api接口被封禁，请登录mp.weixin.qq.com查看详情 </td> 
 </tr> 
 <tr> 
 <td> 48005 </td> 
 <td> api禁止删除被自动回复和自定义菜单引用的素材 </td> 
 </tr> 
 <tr> 
 <td> 48006 </td> 
 <td> api禁止清零调用次数，因为清零次数达到上限 </td> 
 </tr> 
 <tr> 
 <td> 50001 </td> 
 <td> 用户未授权该api </td> 
 </tr> 
 <tr> 
 <td> 50002 </td> 
 <td> 用户受限，可能是违规后接口被封禁 </td> 
 </tr> 
 <tr> 
 <td> 61451 </td> 
 <td> 参数错误(invalid parameter) </td> 
 </tr> 
 <tr> 
 <td> 61452 </td> 
 <td> 无效客服账号(invalid kf_account) </td> 
 </tr> 
 <tr> 
 <td> 61453 </td> 
 <td> 客服帐号已存在(kf_account exsited) </td> 
 </tr> 
 <tr> 
 <td> 61454 </td> 
 <td> 客服帐号名长度超过限制(仅允许10个英文字符，不包括@及@后的公众号的微信号)(invalid &nbsp; kf_acount length) </td> 
 </tr> 
 <tr> 
 <td> 61455 </td> 
 <td> 客服帐号名包含非法字符(仅允许英文+数字)(illegal character in &nbsp; &nbsp; kf_account) </td> 
 </tr> 
 <tr> 
 <td> 61456 </td> 
 <td> 客服帐号个数超过限制(10个客服账号)(kf_account count exceeded) </td> 
 </tr> 
 <tr> 
 <td> 61457 </td> 
 <td> 无效头像文件类型(invalid &nbsp; file type) </td> 
 </tr> 
 <tr> 
 <td> 61450 </td> 
 <td> 系统错误(system error) </td> 
 </tr> 
 <tr> 
 <td> 61500 </td> 
 <td> 日期格式错误 </td> 
 </tr> 
 <tr> 
 <td> 65301 </td> 
 <td> 不存在此menuid对应的个性化菜单 </td> 
 </tr> 
 <tr> 
 <td> 65302 </td> 
 <td> 没有相应的用户 </td> 
 </tr> 
 <tr> 
 <td> 65303 </td> 
 <td> 没有默认菜单，不能创建个性化菜单 </td> 
 </tr> 
 <tr> 
 <td> 65304 </td> 
 <td> MatchRule信息为空 </td> 
 </tr> 
 <tr> 
 <td> 65305 </td> 
 <td> 个性化菜单数量受限 </td> 
 </tr> 
 <tr> 
 <td> 65306 </td> 
 <td> 不支持个性化菜单的帐号 </td> 
 </tr> 
 <tr> 
 <td> 65307 </td> 
 <td> 个性化菜单信息为空 </td> 
 </tr> 
 <tr> 
 <td> 65308 </td> 
 <td> 包含没有响应类型的button </td> 
 </tr> 
 <tr> 
 <td> 65309 </td> 
 <td> 个性化菜单开关处于关闭状态 </td> 
 </tr> 
 <tr> 
 <td> 65310 </td> 
 <td> 填写了省份或城市信息，国家信息不能为空 </td> 
 </tr> 
 <tr> 
 <td> 65311 </td> 
 <td> 填写了城市信息，省份信息不能为空 </td> 
 </tr> 
 <tr> 
 <td> 65312 </td> 
 <td> 不合法的国家信息 </td> 
 </tr> 
 <tr> 
 <td> 65313 </td> 
 <td> 不合法的省份信息 </td> 
 </tr> 
 <tr> 
 <td> 65314 </td> 
 <td> 不合法的城市信息 </td> 
 </tr> 
 <tr> 
 <td> 65316 </td> 
 <td> 该公众号的菜单设置了过多的域名外跳（最多跳转到3个域名的链接） </td> 
 </tr> 
 <tr> 
 <td> 65317 </td> 
 <td> 不合法的URL </td> 
 </tr> 
 <tr> 
 <td> 9001001 </td> 
 <td> POST数据参数不合法 </td> 
 </tr> 
 <tr> 
 <td> 9001002 </td> 
 <td> 远端服务不可用 </td> 
 </tr> 
 <tr> 
 <td> 9001003 </td> 
 <td> Ticket不合法 </td> 
 </tr> 
 <tr> 
 <td> 9001004 </td> 
 <td> 获取摇周边用户信息失败 </td> 
 </tr> 
 <tr> 
 <td> 9001005 </td> 
 <td> 获取商户信息失败 </td> 
 </tr> 
 <tr> 
 <td> 9001006 </td> 
 <td> 获取OpenID失败 </td> 
 </tr> 
 <tr> 
 <td> 9001007 </td> 
 <td> 上传文件缺失 </td> 
 </tr> 
 <tr> 
 <td> 9001008 </td> 
 <td> 上传素材的文件类型不合法 </td> 
 </tr> 
 <tr> 
 <td> 9001009 </td> 
 <td> 上传素材的文件尺寸不合法 </td> 
 </tr> 
 <tr> 
 <td> 9001010 </td> 
 <td> 上传失败 </td> 
 </tr> 
 <tr> 
 <td> 9001020 </td> 
 <td> 帐号不合法 </td> 
 </tr> 
 <tr> 
 <td> 9001021 </td> 
 <td> 已有设备激活率低于50%，不能新增设备 </td> 
 </tr> 
 <tr> 
 <td> 9001022 </td> 
 <td> 设备申请数不合法，必须为大于0的数字 </td> 
 </tr> 
 <tr> 
 <td> 9001023 </td> 
 <td> 已存在审核中的设备ID申请 </td> 
 </tr> 
 <tr> 
 <td> 9001024 </td> 
 <td> 一次查询设备ID数量不能超过50 </td> 
 </tr> 
 <tr> 
 <td> 9001025 </td> 
 <td> 设备ID不合法 </td> 
 </tr> 
 <tr> 
 <td> 9001026 </td> 
 <td> 页面ID不合法 </td> 
 </tr> 
 <tr> 
 <td> 9001027 </td> 
 <td> 页面参数不合法 </td> 
 </tr> 
 <tr> 
 <td> 9001028 </td> 
 <td> 一次删除页面ID数量不能超过10 </td> 
 </tr> 
 <tr> 
 <td> 9001029 </td> 
 <td> 页面已应用在设备中，请先解除应用关系再删除 </td> 
 </tr> 
 <tr> 
 <td> 9001030 </td> 
 <td> 一次查询页面ID数量不能超过50 </td> 
 </tr> 
 <tr> 
 <td> 9001031 </td> 
 <td> 时间区间不合法 </td> 
 </tr> 
 <tr> 
 <td> 9001032 </td> 
 <td> 保存设备与页面的绑定关系参数错误 </td> 
 </tr> 
 <tr> 
 <td> 9001033 </td> 
 <td> 门店ID不合法 </td> 
 </tr> 
 <tr> 
 <td> 9001034 </td> 
 <td> 设备备注信息过长 </td> 
 </tr> 
 <tr> 
 <td> 9001035 </td> 
 <td> 设备申请参数不合法 </td> 
 </tr> 
 <tr> 
 <td> 9001036 </td> 
 <td> 查询起始值begin不合法 </td> 
 </tr> 
 </tbody> 
</table>

[Link 1]: https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1433747234