【文章內(nèi)容簡(jiǎn)介】 （如是否過(guò)期），或查看是否正在為恰當(dāng)?shù)墓娞?hào)調(diào)用接口40015不合法的菜單類(lèi)型40016不合法的按鈕個(gè)數(shù)40017不合法的按鈕個(gè)數(shù)40018不合法的按鈕名字長(zhǎng)度40019不合法的按鈕KEY長(zhǎng)度40020不合法的按鈕URL長(zhǎng)度40021不合法的菜單版本號(hào)40022不合法的子菜單級(jí)數(shù)40023不合法的子菜單按鈕個(gè)數(shù)40024不合法的子菜單按鈕類(lèi)型40025不合法的子菜單按鈕名字長(zhǎng)度40026不合法的子菜單按鈕KEY長(zhǎng)度40027不合法的子菜單按鈕URL長(zhǎng)度40028不合法的自定義菜單使用用戶(hù)40029不合法的oauth_code40030不合法的refresh_token40031不合法的openid列表40032不合法的openid列表長(zhǎng)度40033不合法的請(qǐng)求字符，不能包含\uxxxx格式的字符40035不合法的參數(shù)40038不合法的請(qǐng)求格式40039不合法的URL長(zhǎng)度40050不合法的分組id40051分組名字不合法40117分組名字不合法40118media_id大小不合法40119button類(lèi)型錯(cuò)誤40120button類(lèi)型錯(cuò)誤40121不合法的media_id類(lèi)型41001缺少access_token參數(shù)41002缺少appid參數(shù)41003缺少refresh_token參數(shù)41004缺少secret參數(shù)41005缺少多媒體文件數(shù)據(jù)41006缺少media_id參數(shù)41007缺少子菜單數(shù)據(jù)41008缺少oauth code41009缺少openid42001access_token超時(shí)，請(qǐng)檢查access_token的有效期，請(qǐng)參考基礎(chǔ)支持獲取access_token中，對(duì)access_token的詳細(xì)機(jī)制說(shuō)明42002refresh_token超時(shí)42003oauth_code超時(shí)43001需要GET請(qǐng)求43002需要POST請(qǐng)求43003需要HTTPS請(qǐng)求43004需要接收者關(guān)注43005需要好友關(guān)系44001多媒體文件為空44002POST的數(shù)據(jù)包為空44003圖文消息內(nèi)容為空44004文本消息內(nèi)容為空45001多媒體文件大小超過(guò)限制45002消息內(nèi)容超過(guò)限制45003標(biāo)題字段超過(guò)限制45004描述字段超過(guò)限制45005鏈接字段超過(guò)限制45006圖片鏈接字段超過(guò)限制45007語(yǔ)音播放時(shí)間超過(guò)限制45008圖文消息超過(guò)限制45009接口調(diào)用超過(guò)限制45010創(chuàng)建菜單個(gè)數(shù)超過(guò)限制45015回復(fù)時(shí)間超過(guò)限制45016系統(tǒng)分組，不允許修改45017分組名字過(guò)長(zhǎng)45018分組數(shù)量超過(guò)上限46001不存在媒體數(shù)據(jù)46002不存在的菜單版本46003不存在的菜單數(shù)據(jù)46004不存在的用戶(hù)47001解析JSON/XML內(nèi)容錯(cuò)誤48001api功能未授權(quán)，請(qǐng)確認(rèn)公眾號(hào)已獲得該接口，可以在公眾平臺(tái)官網(wǎng)開(kāi)發(fā)者中心頁(yè)中查看接口權(quán)限50001用戶(hù)未授權(quán)該api50002用戶(hù)受限，可能是違規(guī)后接口被封禁61451參數(shù)錯(cuò)誤(invalid parameter)61452無(wú)效客服賬號(hào)(invalid kf_account)61453客服帳號(hào)已存在(kf_account exsited)61454客服帳號(hào)名長(zhǎng)度超過(guò)限制(僅允許10個(gè)英文字符，不包括@及@后的公眾號(hào)的微信號(hào))(invalid kf_acount length)61455客服帳號(hào)名包含非法字符(僅允許英文+數(shù)字)(illegal character in kf_account)61456客服帳號(hào)個(gè)數(shù)超過(guò)限制(10個(gè)客服賬號(hào))(kf_account count exceeded)61457無(wú)效頭像文件類(lèi)型(invalid file type)61450系統(tǒng)錯(cuò)誤(system error)61500日期格式錯(cuò)誤61501日期范圍錯(cuò)誤9001001POST數(shù)據(jù)參數(shù)不合法9001002遠(yuǎn)端服務(wù)不可用9001003Ticket不合法9001004獲取搖周邊用戶(hù)信息失敗9001005獲取商戶(hù)信息失敗9001006獲取OpenID失敗9001007上傳文件缺失9001008上傳素材的文件類(lèi)型不合法9001009上傳素材的文件尺寸不合法9001010上傳失敗9001020帳號(hào)不合法9001021已有設(shè)備激活率低于50%，不能新增設(shè)備9001022設(shè)備申請(qǐng)數(shù)不合法，必須為大于0的數(shù)字9001023已存在審核中的設(shè)備ID申請(qǐng)9001024一次查詢(xún)?cè)O(shè)備ID數(shù)量不能超過(guò)509001025設(shè)備ID不合法9001026頁(yè)面ID不合法9001027頁(yè)面參數(shù)不合法9001028一次刪除頁(yè)面ID數(shù)量不能超過(guò)109001029頁(yè)面已應(yīng)用在設(shè)備中，請(qǐng)先解除應(yīng)用關(guān)系再刪除9001030一次查詢(xún)頁(yè)面ID數(shù)量不能超過(guò)509001031時(shí)間區(qū)間不合法9001032保存設(shè)備與頁(yè)面的綁定關(guān)系參數(shù)錯(cuò)誤9001033門(mén)店ID不合法9001034設(shè)備備注信息過(guò)長(zhǎng)9001035設(shè)備申請(qǐng)參數(shù)不合法9001036查詢(xún)起始值begin不合法報(bào)警排查指引目錄 1概要說(shuō)明 2報(bào)警內(nèi)容說(shuō)明 3各類(lèi)報(bào)警的排查方法 4常見(jiàn)問(wèn)題 5附錄o 附錄1：微信推送的消息事件列表和響應(yīng)格式o 附錄2：查看服務(wù)器性能負(fù)載的常用工具o 附錄3：nginx配置和排查指引概要說(shuō)明微信公眾平臺(tái)已對(duì)外開(kāi)放接口報(bào)警，當(dāng)微信服務(wù)器向開(kāi)發(fā)者推送消息失敗次數(shù)達(dá)到預(yù)定閾值時(shí)，會(huì)將報(bào)警消息發(fā)送到指定微信報(bào)警群中（設(shè)置方式：公眾平臺(tái)開(kāi)發(fā)者中心接口報(bào)警），請(qǐng)開(kāi)發(fā)者積極主動(dòng)關(guān)注報(bào)警，即時(shí)解決故障，提高微信公眾號(hào)的服務(wù)質(zhì)量。為了更好地根據(jù)報(bào)警信息尾部的實(shí)例（提供了openid及時(shí)間戳stamp）進(jìn)行問(wèn)題排查，開(kāi)發(fā)者需要在接入層、邏輯層等每一個(gè)層級(jí)都加上包含關(guān)鍵信息的詳細(xì)日志，以利于快速定位問(wèn)題。報(bào)警目前有2類(lèi)：，所有開(kāi)發(fā)者都需要關(guān)注。類(lèi)型描述DNS失敗微信服務(wù)器向公眾號(hào)推送消息或事件時(shí)，解析DNS失敗DNS超時(shí)微信服務(wù)器向公眾號(hào)推送消息或事件時(shí)，解析DNS超時(shí)，超時(shí)時(shí)間為5秒連接超時(shí)微信服務(wù)器連接公眾號(hào)開(kāi)發(fā)者服務(wù)器時(shí)發(fā)生超時(shí)，超時(shí)時(shí)間為3秒請(qǐng)求超時(shí)微信服務(wù)器向公眾號(hào)推送消息或事件后，開(kāi)發(fā)者5秒內(nèi)沒(méi)有返回回應(yīng)失敗微信服務(wù)器向公眾號(hào)推送消息或事件后，得到的回應(yīng)不合法MarkFail（自動(dòng)屏蔽）微信服務(wù)器向公眾號(hào)推送消息或事件發(fā)生多次失敗后，暫時(shí)不推送消息，一分鐘后解除屏蔽，只有在微信開(kāi)放平臺(tái)（）上申請(qǐng)成為公眾號(hào)第三方平臺(tái)的開(kāi)發(fā)者，才需要關(guān)注此報(bào)警。類(lèi)型描述推送ponent_verify_ticket超時(shí)推送ponent_verify_ticket時(shí)，開(kāi)發(fā)者5S內(nèi)沒(méi)有返回推送ponent_verify_ticket失敗推送ponent_verify_ticket時(shí)，開(kāi)發(fā)者沒(méi)有返回success推送第三方平臺(tái)消息超時(shí)推送第三方平臺(tái)消息（如取消授權(quán)消息）等，第三方平臺(tái)5秒內(nèi)沒(méi)有返回推送第三方平臺(tái)消息失敗推送第三方平臺(tái)消息（如取消授權(quán)消息）等，第三方平臺(tái)沒(méi)有返回success下面對(duì)具體的報(bào)警做示例以及排查指引說(shuō)明。報(bào)警內(nèi)容說(shuō)明報(bào)警內(nèi)容描述：a)appid：公眾號(hào)appidb)昵稱(chēng): 公眾號(hào)昵稱(chēng)c)時(shí)間：所有報(bào)警，都會(huì)提供首次發(fā)生異常的時(shí)間。（如首次發(fā)生超時(shí)的時(shí)間，首次發(fā)生回應(yīng)失敗的時(shí)間）d)內(nèi)容：錯(cuò)誤的具體描述e)次數(shù)：發(fā)生失敗的次數(shù)f)錯(cuò)誤樣例：錯(cuò)誤樣例里注明了一些幫助查找問(wèn)題的信息。如：首次超時(shí)開(kāi)發(fā)者的IP和推送消息類(lèi)型。如果是回應(yīng)失敗，錯(cuò)誤樣例還會(huì)注明首次回應(yīng)失敗時(shí)開(kāi)發(fā)者的回包。一般情況下，通過(guò)報(bào)警提供的IP，時(shí)間，消息類(lèi)型，能夠比較快速的定位到第三方發(fā)生問(wèn)題的原因。報(bào)警示例1：超時(shí)報(bào)警Appid: wxxxxxx昵稱(chēng): WxNickName時(shí)間: 20141201 20:12:00內(nèi)容: 微信服務(wù)器向公眾號(hào)推送消息或事件后，開(kāi)發(fā)者5秒內(nèi)沒(méi)有返回次數(shù): 5分鐘 1272次錯(cuò)誤樣例: [IP=][Event=UnSubscribe]該報(bào)警表示：微信服務(wù)器向開(kāi)發(fā)者推送取消關(guān)注事件時(shí)，開(kāi)發(fā)者沒(méi)有在5秒內(nèi)返回結(jié)果。在20141201 20:12:0020141201 20:17:00這5分鐘內(nèi)發(fā)生了1272次。其中這5分鐘內(nèi)第一次發(fā)生超時(shí)的時(shí)間是：20141201 20:12:00， 開(kāi)發(fā)者的IP是：，事件類(lèi)型是取消關(guān)注事件。報(bào)警示例2：回應(yīng)失敗Appid: wxxxx昵稱(chēng): WxNickName時(shí)間: 20141201 20:12:00內(nèi)容: 微信服務(wù)器向公眾號(hào)推送消息或事件后，得到的回應(yīng)不合法次數(shù): 5分鐘 1320次錯(cuò)誤樣例: [Event=Click] [ip=][response_length=10][response_content=Error 500:]該報(bào)警表示：微信服務(wù)器向開(kāi)發(fā)者推送自定義菜單點(diǎn)擊事件時(shí)，開(kāi)發(fā)者的返回結(jié)果不合法。在20141201 20:12:0020141201 20:17:00這5分鐘內(nèi)發(fā)生了1320次。其中這5分鐘內(nèi)第一次發(fā)生回應(yīng)失敗的時(shí)間是：20141201 20:12:00， 開(kāi)發(fā)者的IP是：，事件類(lèi)型是點(diǎn)擊菜單事件，第三方返回的內(nèi)容長(zhǎng)度為10個(gè)字節(jié)，內(nèi)容為“Error 500:”。報(bào)警示例3：連接超時(shí)Appid: wxxxx昵稱(chēng): WxNickName時(shí)間: 20150204 20:13:09內(nèi)容: 微信服務(wù)器連接公眾號(hào)開(kāi)發(fā)者服務(wù)器時(shí)發(fā)生超時(shí)，超時(shí)時(shí)間為5秒次數(shù): 5分鐘 7289次錯(cuò)誤樣例: [IP=][Msg=Text]該報(bào)警表示：微信服務(wù)器向開(kāi)發(fā)者推送粉絲發(fā)來(lái)的文本消息時(shí)，無(wú)法連接到開(kāi)發(fā)者填寫(xiě)的服務(wù)器地址。在20150204 20:13:0920150204 20:18:00這5分鐘內(nèi)發(fā)生了7289次，這5分鐘內(nèi)第一次發(fā)生連接超時(shí)的時(shí)間是：20150204 20:13:09， 開(kāi)發(fā)者的IP是：，事件類(lèi)型是用戶(hù)推送的消息。各類(lèi)報(bào)警的排查方法該錯(cuò)誤為微信服務(wù)器在推送消息給開(kāi)發(fā)者時(shí)，解析dns失敗。如遇到此報(bào)警，請(qǐng)開(kāi)發(fā)者確認(rèn)：a）填寫(xiě)的url,域名是否有誤；b) 域名是否發(fā)生變化，如過(guò)期，更新等。如果不是以上2個(gè)問(wèn)題，請(qǐng)聯(lián)系微信公眾平臺(tái)。目前不會(huì)有此錯(cuò)誤。該錯(cuò)誤是微信服務(wù)器和開(kāi)發(fā)者服務(wù)器3S內(nèi)未連接成功。報(bào)警消息會(huì)提供出首次發(fā)生連接失敗的時(shí)間和連接的IP。如遇此報(bào)警，請(qǐng)開(kāi)發(fā)者確認(rèn)：a)該IP是否有誤。b)該IP機(jī)器是否過(guò)載，連接過(guò)多。c)如果是第三方提供服務(wù)器托管，托管商是否有故障。d)網(wǎng)絡(luò)運(yùn)營(yíng)商是否有故障。微信服務(wù)器向開(kāi)發(fā)者服務(wù)器推送消息或事件，開(kāi)發(fā)者5秒內(nèi)沒(méi)有返回。請(qǐng)求超時(shí)時(shí)，報(bào)警消息會(huì)提供第一次出現(xiàn)請(qǐng)求超時(shí)的時(shí)間，開(kāi)發(fā)者IP和消息類(lèi)型。請(qǐng)開(kāi)發(fā)者確認(rèn)：a）該IP是否有誤b）該IP是否接收到報(bào)警消息給出的該消息類(lèi)型的請(qǐng)求c）該請(qǐng)求是否處理時(shí)間過(guò)長(zhǎng)開(kāi)發(fā)者沒(méi)有按照wiki中的回復(fù)消息格式進(jìn)行回復(fù)消息，或者發(fā)生網(wǎng)絡(luò)錯(cuò)誤，會(huì)報(bào)警回應(yīng)失敗，報(bào)警消息會(huì)提供第一次出現(xiàn)請(qǐng)求回應(yīng)失敗的時(shí)間，開(kāi)發(fā)者的IP，消息類(lèi)型以及回應(yīng)的消息內(nèi)容，請(qǐng)開(kāi)發(fā)者確認(rèn)：a）該IP是否有誤b）該IP是否發(fā)生網(wǎng)絡(luò)錯(cuò)誤c）該業(yè)務(wù)處理邏輯是否沒(méi)有按照wiki規(guī)范回復(fù)消息，或是進(jìn)入了異常邏輯。（自動(dòng)屏蔽）微信后臺(tái)會(huì)實(shí)時(shí)統(tǒng)計(jì)開(kāi)發(fā)者的失敗次數(shù)。在推送消息給開(kāi)發(fā)者發(fā)生大量失敗時(shí)，微信服務(wù)器會(huì)自動(dòng)屏蔽開(kāi)發(fā)者，1分鐘內(nèi)不再推送任何消息，并會(huì)發(fā)送報(bào)警到微信群。此報(bào)警是級(jí)別最高的報(bào)警，開(kāi)發(fā)者在收到此報(bào)警時(shí)請(qǐng)盡快處理后臺(tái)故障，恢復(fù)服務(wù)。事實(shí)上，開(kāi)發(fā)者在收到此報(bào)警前，必然會(huì)收到連接超時(shí)，請(qǐng)求超時(shí)或回應(yīng)失敗等報(bào)警，需要開(kāi)發(fā)者即時(shí)去解決這些故障，避免被微信服務(wù)器屏蔽，嚴(yán)重影響公眾號(hào)服務(wù)！ amp。 amp。 amp。 以上4個(gè)報(bào)警只有公眾號(hào)第三方平臺(tái)開(kāi)發(fā)者會(huì)收到，其他公眾號(hào)開(kāi)發(fā)者無(wú)需關(guān)注。由于公眾號(hào)第三方平臺(tái)承載了更多的公眾號(hào)，所以公眾號(hào)第三方平臺(tái)的服務(wù)質(zhì)量需要更嚴(yán)格要求和報(bào)警，所以把這4個(gè)特殊的事件單獨(dú)報(bào)警。具體的問(wèn)題查找方式與4，5是一樣的，這里不在贅述。關(guān)于公眾號(hào)第三方平臺(tái)的具體申請(qǐng)與開(kāi)發(fā)實(shí)現(xiàn)，請(qǐng)前往微信開(kāi)放平臺(tái)（）常見(jiàn)問(wèn)題？，確認(rèn)是否能夠得到正確的IP。如不能得到或者錯(cuò)誤，請(qǐng)到你們的域名托管商管理系統(tǒng)上檢查配置。，又有DNS失敗的報(bào)警； 來(lái)再測(cè)試驗(yàn)證。Linux: dig @ 域名；windows 修改網(wǎng)絡(luò)配置里的DNS服務(wù)器地址，然后再ping 域名。如果得到的IP不正確或者得不到，請(qǐng)聯(lián)系微信團(tuán)隊(duì)。？。（1）使用公眾平臺(tái)接口，獲取到微信回調(diào)服務(wù)器的IP，（2）在你們的服務(wù)上ping 測(cè)試，檢查你們服務(wù)器到微信回調(diào)用服務(wù)器的網(wǎng)絡(luò)質(zhì)量情況。如有網(wǎng)絡(luò)問(wèn)題，請(qǐng)聯(lián)系你們的服務(wù)器提