微信公眾號開發報錯 返回碼說明
阿新 • • 發佈：2019-02-12
全域性返回碼說明
公眾號每次呼叫介面時，可能獲得正確或錯誤的返回碼，開發者可以根據返回碼資訊除錯介面，排查錯誤。
全域性返回碼說明如下：（更新時間：2018年8月6日）
| -1 | 系統繁忙，此時請開發者稍候再試 |
| 0 | 請求成功 |
| 40001 | 獲取 access_token 時 AppSecret 錯誤，或者 access_token 無效。請開發者認真比對 AppSecret 的正確性，或檢視是否正在為恰當的公眾號呼叫介面 |
| 40002 | 不合法的憑證型別 |
| 40003 | 不合法的 OpenID ，請開發者確認 OpenID （該使用者）是否已關注公眾號，或是否是其他公眾號的 OpenID |
| 40004 | 不合法的媒體檔案型別 |
| 40005 | 不合法的檔案型別 |
| 40006 | 不合法的檔案大小 |
| 40007 | 不合法的媒體檔案 id |
| 40008 | 不合法的訊息型別 |
| 40009 | 不合法的圖片檔案大小 |
| 40010 | 不合法的語音檔案大小 |
| 40011 | 不合法的視訊檔案大小 |
| 40012 | 不合法的縮圖檔案大小 |
| 40013 | 不合法的 AppID ，請開發者檢查 AppID 的正確性，避免異常字元，注意大小寫 |
| 40014 | 不合法的 access_token ，請開發者認真比對 access_token 的有效性（如是否過期），或檢視是否正在為恰當的公眾號呼叫介面 |
| 40015 | 不合法的選單型別 |
| 40016 | 不合法的按鈕個數 |
| 40017 | 不合法的按鈕個數 |
| 40018 | 不合法的按鈕名字長度 |
| 40019 | 不合法的按鈕 KEY 長度 |
| 40020 | 不合法的按鈕 URL 長度 |
| 40021 | 不合法的選單版本號 |
| 40022 | 不合法的子選單級數 |
| 40023 | 不合法的子選單按鈕個數 |
| 40024 | 不合法的子選單按鈕型別 |
| 40025 | 不合法的子選單按鈕名字長度 |
| 40026 | 不合法的子選單按鈕 KEY 長度 |
| 40027 | 不合法的子選單按鈕 URL 長度 |
| 40028 | 不合法的自定義選單使用使用者 |
| 40029 | 不合法的 oauth_code |
| 40030 | 不合法的 refresh_token |
| 40031 | 不合法的 openid 列表 |
| 40032 | 不合法的 openid 列表長度 |
| 40033 | 不合法的請求字元，不能包含 \uxxxx 格式的字元 |
| 40035 | 不合法的引數 |
| 40038 | 不合法的請求格式 |
| 40039 | 不合法的 URL 長度 |
| 40050 | 不合法的分組 id |
| 40051 | 分組名字不合法 |
| 40060 | 刪除單篇圖文時，指定的 article_idx 不合法 |
| 40117 | 分組名字不合法 |
| 40118 | media_id 大小不合法 |
| 40119 | button 型別錯誤 |
| 40120 | button 型別錯誤 |
| 40121 | 不合法的 media_id 型別 |
| 40132 | 微訊號不合法 |
| 40137 | 不支援的圖片格式 |
| 40155 | 請勿新增其他公眾號的主頁連結 |
| 41001 | 缺少 access_token 引數 |
| 41002 | 缺少 appid 引數 |
| 41003 | 缺少 refresh_token 引數 |
| 41004 | 缺少 secret 引數 |
| 41005 | 缺少多媒體檔案資料 |
| 41006 | 缺少 media_id 引數 |
| 41007 | 缺少子選單資料 |
| 41008 | 缺少 oauth code |
| 41009 | 缺少 openid |
| 42001 | access_token 超時，請檢查 access_token 的有效期，請參考基礎支援 - 獲取 access_token 中，對 access_token 的詳細機制說明 |
| 42002 | refresh_token 超時 |
| 42003 | oauth_code 超時 |
| 42007 | 使用者修改微信密碼， accesstoken 和 refreshtoken 失效，需要重新授權 |
| 43001 | 需要 GET 請求 |
| 43002 | 需要 POST 請求 |
| 43003 | 需要 HTTPS 請求 |
| 43004 | 需要接收者關注 |
| 43005 | 需要好友關係 |
| 43019 | 需要將接收者從黑名單中移除 |
| 44001 | 多媒體檔案為空 |
| 44002 | POST 的資料包為空 |
| 44003 | 圖文訊息內容為空 |
| 44004 | 文字訊息內容為空 |
| 45001 | 多媒體檔案大小超過限制 |
| 45002 | 訊息內容超過限制 |
| 45003 | 標題欄位超過限制 |
| 45004 | 描述欄位超過限制 |
| 45005 | 連結欄位超過限制 |
| 45006 | 圖片連結欄位超過限制 |
| 45007 | 語音播放時間超過限制 |
| 45008 | 圖文訊息超過限制 |
| 45009 | 介面呼叫超過限制 |
| 45010 | 建立選單個數超過限制 |
| 45011 | API 呼叫太頻繁，請稍候再試 |
| 45015 | 回覆時間超過限制 |
| 45016 | 系統分組，不允許修改 |
| 45017 | 分組名字過長 |
| 45018 | 分組數量超過上限 |
| 45047 | 客服介面下行條數超過上限 |
| 46001 | 不存在媒體資料 |
| 46002 | 不存在的選單版本 |
| 46003 | 不存在的選單資料 |
| 46004 | 不存在的使用者 |
| 47001 | 解析 JSON/XML 內容錯誤 |
| 48001 | api 功能未授權，請確認公眾號已獲得該介面，可以在公眾平臺官網 - 開發者中心頁中檢視介面許可權 |
| 48002 | 粉絲拒收訊息（粉絲在公眾號選項中，關閉了 “ 接收訊息 ” ） |
| 48004 | api 介面被封禁，請登入 mp.weixin.qq.com 檢視詳情 |
| 48005 | api 禁止刪除被自動回覆和自定義選單引用的素材 |
| 48006 | api 禁止清零呼叫次數，因為清零次數達到上限 |
| 48008 | 沒有該型別訊息的傳送許可權 |
| 50001 | 使用者未授權該 api |
| 50002 | 使用者受限，可能是違規後接口被封禁 |
| 50005 | 使用者未關注公眾號 |
| 61451 | 引數錯誤 (invalid parameter) |
| 61452 | 無效客服賬號 (invalid kf_account) |
| 61453 | 客服帳號已存在 (kf_account exsited) |
| 61454 | 客服帳號名長度超過限制 ( 僅允許 10 個英文字元，不包括 @ 及 @ 後的公眾號的微訊號 )(invalid kf_acount length) |
| 61455 | 客服帳號名包含非法字元 ( 僅允許英文 + 數字 )(illegal character in kf_account) |
| 61456 | 客服帳號個數超過限制 (10 個客服賬號 )(kf_account count exceeded) |
| 61457 | 無效頭像檔案型別 (invalid file type) |
| 61450 | 系統錯誤 (system error) |
| 61500 | 日期格式錯誤 |
| 65301 | 不存在此 menuid 對應的個性化選單 |
| 65302 | 沒有相應的使用者 |
| 65303 | 沒有預設選單，不能建立個性化選單 |
| 65304 | MatchRule 資訊為空 |
| 65305 | 個性化選單數量受限 |
| 65306 | 不支援個性化選單的帳號 |
| 65307 | 個性化選單資訊為空 |
| 65308 | 包含沒有響應型別的 button |
| 65309 | 個性化選單開關處於關閉狀態 |
| 65310 | 填寫了省份或城市資訊，國家資訊不能為空 |
| 65311 | 填寫了城市資訊，省份資訊不能為空 |
| 65312 | 不合法的國家資訊 |
| 65313 | 不合法的省份資訊 |
| 65314 | 不合法的城市資訊 |
| 65316 | 該公眾號的選單設定了過多的域名外跳（最多跳轉到 3 個域名的連結） |
| 65317 | 不合法的 URL |
| 9001001 | POST 資料引數不合法 |
| 9001002 | 遠端服務不可用 |
| 9001003 | Ticket 不合法 |
| 9001004 | 獲取搖周邊使用者資訊失敗 |
| 9001005 | 獲取商戶資訊失敗 |
| 9001006 | 獲取 OpenID 失敗 |
| 9001007 | 上傳檔案缺失 |
| 9001008 | 上傳素材的檔案型別不合法 |
| 9001009 | 上傳素材的檔案尺寸不合法 |
| 9001010 | 上傳失敗 |
| 9001020 | 帳號不合法 |
| 9001021 | 已有裝置啟用率低於 50% ，不能新增裝置 |
| 9001022 | 裝置申請數不合法，必須為大於 0 的數字 |
| 9001023 | 已存在稽核中的裝置 ID 申請 |
| 9001024 | 一次查詢裝置 ID 數量不能超過 50 |
| 9001025 | 裝置 ID 不合法 |
| 9001026 | 頁面 ID 不合法 |
| 9001027 | 頁面引數不合法 |
| 9001028 | 一次刪除頁面 ID 數量不能超過 10 |
| 9001029 | 頁面已應用在裝置中，請先解除應用關係再刪除 |
| 9001030 | 一次查詢頁面 ID 數量不能超過 50 |
| 9001031 | 時間區間不合法 |
| 9001032 | 儲存裝置與頁面的繫結關係引數錯誤 |
| 9001033 | 門店 ID 不合法 |
| 9001034 | 裝置備註資訊過長 |
| 9001035 | 裝置申請引數不合法 |
| 9001036 | 查詢起始值 begin 不合法 |