微信公众号开发报错返回码说明

矫情吗；* 2021-08-27 23:16 606阅读 0赞

更新时间 20200402

官网地址：[https://developers.weixin.qq.com/doc/offiaccount/Getting\_Started/Global\_Return\_Code.html][https_developers.weixin.qq.com_doc_offiaccount_Getting_Started_Global_Return_Code.html]

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

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

<table> 
 <thead> 
  <tr> 
   <th>返回码</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <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>40048</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>40125</td> 
   <td>无效的appsecret</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>40163</td> 
   <td>oauth_code已使用</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>45064</td> 
   <td>创建菜单包含未关联的小程序</td> 
  </tr> 
  <tr> 
   <td>45065</td> 
   <td>相同 clientmsgid 已存在群发记录，返回数据中带有已存在的群发任务的 msgid</td> 
  </tr> 
  <tr> 
   <td>45066</td> 
   <td>相同 clientmsgid 重试速度过快，请间隔1分钟重试</td> 
  </tr> 
  <tr> 
   <td>45067</td> 
   <td>clientmsgid 长度超过限制</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>48008</td> 
   <td>没有该类型消息的发送权限</td> 
  </tr> 
  <tr> 
   <td>50001</td> 
   <td>用户未授权该 api</td> 
  </tr> 
  <tr> 
   <td>50002</td> 
   <td>用户受限，可能是违规后接口被封禁</td> 
  </tr> 
  <tr> 
   <td>50005</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>63001</td> 
   <td>部分参数为空</td> 
  </tr> 
  <tr> 
   <td>63002</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>87009</td> 
   <td>无效的签名</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>

[https_developers.weixin.qq.com_doc_offiaccount_Getting_Started_Global_Return_Code.html]: https://developers.weixin.qq.com/doc/offiaccount/Getting_Started/Global_Return_Code.html