# 公共错误码

调用微信小店 API 时，若返回的 `errcode` 不为 `0`，请根据以下错误码进行排查。

> 各业务接口可能还有额外的业务错误码，请在对应接口文档中查看。

## 请求成功与系统错误

| 错误码 | 错误信息 | 解决方法 |
|-------|---------|---------|
| 0 | ok | 请求成功 |
| -1 | system error | 系统繁忙，此时请开发者稍候再试 |

## 凭证与鉴权

| 错误码 | 错误信息 | 解决方法 |
|-------|---------|---------|
| 40001 | invalid credential, access_token is invalid or not latest, could get access_token by getStableAccessToken, more details at https://mmbizurl.cn/s/JtxxFh33r | access_token 无效或不是最新，请认真检查 AppSecret 的正确性，可通过 [getStableAccessToken](https://mmbizurl.cn/s/JtxxFh33r) 重新获取 |
| 41001 | access_token missing | 缺少 access_token 参数 |
| 42001 | access_token expired | access_token 已失效，需要重新[获取 access_token](https://mmbizurl.cn/s/JtxxFh33r) |
| 41002 | appid missing | 请检查 URL 参数中是否有 ?appid= |
| 41018 | missing component_appid | 请检查 POST JSON 中是否包含 component_appid 字段 |

## 参数校验

| 错误码 | 错误信息 | 解决方法 |
|-------|---------|---------|
| 40003 | invalid openid | 请检查 openid 的正确性 |
| 40013 | invalid appid | 请检查 appid 的正确性，避免异常字符，注意大小写 |
| 40066 | invalid url | 请检查 API 的 URL 是否与文档一致 |
| 40097 | invalid request body | 请求体参数不正确，请检查各个参数是否按规范填写，具体原因请查看 errmsg |
| 44002 | empty post data | POST 的数据包为空 |
| 45002 | content size out of limit | 请对数据进行压缩 |
| 47001 | data format error | 解析 JSON/XML 内容错误 |

## 频率与配额

| 错误码 | 错误信息 | 解决方法 |
|-------|---------|---------|
| 45009 | reach max api daily quota limit | API 日调用配额已达上限，可通过 get_api_quota 接口获取每天的调用 quota；用完后可通过 clear_quota 进行清空 |
| 45011 | api minute-quota reach limit must slower retry next minute | 命中每分钟的频率限制，请稍后重试 |

## 权限与授权

| 错误码 | 错误信息 | 解决方法 |
|-------|---------|---------|
| 48001 | api unauthorized | 没有该接口权限 |
| 48004 | api forbidden for irregularities | 接口因违规被禁用 |
| 50001 | user unauthorized | 请找用户获取该 API 授权 |
| 50002 | user limited | 请检查封禁原因 |
| 61007 | api is unauthorized to component | 请检查第三方平台服务商已获取的授权集 |

## 请求方式与网络安全

| 错误码 | 错误信息 | 解决方法 |
|-------|---------|---------|
| 43002 | require POST method | 请检查 API 请求的 Method 是否为 POST |
| 43003 | require https | 请使用 HTTPS 方式请求，不要使用 HTTP 方式 |
| 45035 | access clientip is not registered, not in ip-white-list | 需要登录 [微信小店后台](https://store.weixin.qq.com/shop/home) 配置 IP 白名单 |
| 61004 | access clientip is not registered, not in ip-white-list | 需要登录 [微信小店后台](https://store.weixin.qq.com/shop/home) 配置 IP 白名单 |

## 账号状态

| 错误码 | 错误信息 | 解决方法 |
|-------|---------|---------|
| 43119 | account is restricted | 当前账号的相关功能被限制使用，请检查站内信通知 |
| 43120 | account in the request parameter is restricted | 请求参数中账号的相关功能被限制使用，请检查相关账号的站内信通知 |
| 10080000 | 账号发起注销，进入注销公示期 | 需要登录 [微信小店后台](https://store.weixin.qq.com/shop/home) 继续完成注销 |
| 10080001 | 账号已注销 | — |
| 10080002 | 小店的视频号带货身份为达人号，不允许使用该功能，如需使用，请将带货身份修改为商家 | — |

![](https://res8.wxqcloud.qq.com.cn/wxdoc/56617deb-b17d-4cf1-bccd-71d2c41ccc76.svg)文档变更日志（1条）
2026 年 06 月 16 日`errcode`  字段新增「40097」等1个枚举类型，文档描述优化