top錯誤診斷說明

1、.：.；一、 錯誤處置流程概覽從這個錯誤處置流程可知，在整個錯誤處置的過程中，一共可以分為3條主要的流程：懇求解析異常流程處置，平臺級錯誤處置和業(yè)務調(diào)用錯誤處置。當然，這一切處置的最初也是最重要的一步就是：將效力器呼應內(nèi)容保管下來。二、 效力器呼應內(nèi)容透析效力器呼應內(nèi)容，顧名思義就是isv調(diào)用top效力得到的呼應的內(nèi)容。這些內(nèi)容可以最真實的反響出isv懇求的問題和效力器當前的情況，也最可以協(xié)助 isv找到問題的所在。效力器呼應內(nèi)容普通分為兩種：一種是wiki文檔中所編寫的勝利調(diào)用所前往的字段，另一種是調(diào)用失敗的前往的錯誤相關信息。1. 調(diào)用勝利前往格式調(diào)用勝利的呼應信息內(nèi)容根據(jù)調(diào)用效力版本的不

2、同分為了兩種不同的格式。1.0的效力前往信息的格式分為三層：最外一層是rsp: 標志，表示這是效力的呼應內(nèi)容；中間一層是前往構造體的標志，如：前往的是商品的構造體，中間這層就是items: , ，表示結(jié)果是一個商品的列表，假設前往參數(shù)不是以構造體的方式，這一層就不存在；最內(nèi)一層就是每個構造體詳細的字段了。1.0這個版本一切前往結(jié)果，不論是單個的商品還是一個商品列表，他的第二層都是一個列表的構造，區(qū)別只是列表里有一個子構造體還是有多個子構造體而已。相比之下，2.0的效力前往信息就相對的規(guī)范化了。2.0的呼應內(nèi)容主要也可以分為3層：最外一層是他調(diào)用效力的稱號所對應的呼應標志，如：獲取單個商品tao

3、bao.item.get的呼應最外層為item_get_response: ，表示這是獲取單個商品的呼應；中間一層是前往構造體的標志。假設構造體是單個，那么2.0前往的這一層里面就會是單個的構造，如：獲取的單個商品的構造體就是item: ；反之，假設構造體是多個，那么列表也會明顯的表示出來，如：搜索商品列表的構造體就會是items:“item: , 。最外層的items表示這是一個商品的列表，后面的item表示列表中的每一個子構造體都是屬于商品item的，然后就跟著商品的數(shù)據(jù)；最內(nèi)一層就商品的詳細字段信息了。2. 調(diào)用錯誤前往當調(diào)用發(fā)生錯誤的時候，普通情況下可以分為幾大類錯誤信息的前往：htt

4、p銜接錯誤、平臺解析錯誤、業(yè)務處置錯誤。這三種類型的錯誤分別代表了：淘寶效力器、淘寶接入平臺、top-api業(yè)務，幾個層次上出現(xiàn)的問題。1) http銜接錯誤http銜接錯誤是懇求通訊過程中出現(xiàn)的錯誤，這類型錯誤通常由http呼應碼標志出來。http呼應碼由三位十進制數(shù)字組成，它們出如今由HTTP效力器發(fā)送的呼應的第一行。呼應碼分五種類型，由它們的第一位數(shù)字表示：1xx：信息，懇求收到，繼續(xù)處置2xx：勝利，行為被勝利地接受、了解和采用3xx：重定向，為了完成懇求，必需進一步執(zhí)行的動作4xx：客戶端錯誤，懇求包含語法錯誤或者懇求無法實現(xiàn)5xx：效力器錯誤，效力器不能實現(xiàn)一種明顯無效的懇求Isv

5、調(diào)用top效力最常收到就是200：http懇求勝利；404：未找到懇求的效力；500內(nèi)部效力器錯誤等等。假設用戶收到的呼應碼是404，表示用戶的網(wǎng)絡有問題或者top被調(diào)和了假設用戶收到的呼應碼是500，表示網(wǎng)絡是ok的，是top的效力無法呼應。2) 效力端錯誤總述平臺解析錯誤和業(yè)務處置錯誤都是http勝利訪問到top效力http呼應碼前往為200之后所產(chǎn)生的錯信息，他們top處置isv懇求過程中出現(xiàn)的問題。1.0和2.0的格式有所不同。1.0的錯誤呼應信息最外層為“error_rsp: ,表示這是調(diào)用錯誤所前往的信息。里面一層包含兩個元素：code: 和 “msg: ，前者表示錯誤碼是多少，后

6、者表示錯誤信息是什么。例如錯誤的調(diào)用1.0的taobao.item.get效力錯誤時前往的錯誤信息：error_rsp:code:40,msg:Missing required arguments:missing parameter iid/num_iid。這個信息的開頭為error_rsp，表示這是調(diào)用錯誤所前往的結(jié)果。里面包含的錯誤體的code為40，是平臺型錯誤，表示錯誤是短少了必傳參數(shù)所引起的。然后msg內(nèi)容為Missing required arguments:missing parameter iid/num_iid，表示短少的必傳參數(shù)是iid或者num_iid。Isv解析到這些信

7、息后就需求根據(jù)錯誤信息改良本人傳入的參數(shù)來使調(diào)用勝利。2.0的錯誤呼應信息的最外層為“error_response: ，表示這是調(diào)用效力失敗所前往的錯誤信息。信息體里面一層總共包含了五個元素：args:arg:“key:“ ,value: ,“key:“ ,value: ,“key:“ ,value: ，code: ， “msg: ，sub_code: 和sub_msg: 。args表示用戶傳入的參數(shù)列表是什么，里面是一個arg的列表會包含用戶傳入的一切參數(shù)信息，每個arg表示一個參數(shù)的信息，key表示參數(shù)的稱號，value表示參數(shù)的內(nèi)容，用以方便用戶定位本人的錯誤；code表示用戶調(diào)用錯誤的

8、錯誤碼是多少，小于200表示平臺級錯誤，200-1000之間表示大范圍的業(yè)務錯誤，即哪一類型的api調(diào)用發(fā)生了錯誤根據(jù)api的大類來分，如：商品類的api是530，買賣類的api是520，等；msg表示大類型的錯誤碼所對應的錯誤信息，普通不具備獨立的debug作用，需求和sub_code和sub_msg一同運用才行；sub_code是調(diào)用錯誤的子錯誤碼，他表示用戶調(diào)用錯誤的緣由；sub_msg是子錯誤碼所對應的錯誤信息，他用來補充細化子錯誤碼的錯誤緣由的。例如調(diào)用2.0的taobao.item.get效力錯誤時前往的錯誤信息：error_response:args:arg:key:app_ke

9、y,value:15739,key:fields,value:list_time,delist_time,approve_status,key:format,value:json,key:method,value:taobao.item.get,key:nick,value:tbtest561,key:partner_id,value:TOPTEST,key:sign,value:668FB4A049F71A1C845EF8C05B1F3E66,key:timestamp,value:2021-03-05 18:03:06.325,key:v,value:2.0,code:530,msg:Re

10、mote service error,sub_code:missing-parameter,sub_msg:iid和num_iid至少要傳入一個這個信息的開頭為error_response，表示這是調(diào)用錯誤所前往的錯誤信息。里面的args列出了用調(diào)用這個接口傳入的信息有：key:app_key,value:15739,key:fields,value:list_time,delist_time,approve_status,key:format,value:json,key:method,value:taobao.item.get,key:nick,value:tbtest561,key:pa

11、rtner_id,value:TOPTEST,key:sign,value:668FB4A049F71A1C845EF8C05B1F3E66,key:timestamp,value:2021-03-05 18:03:06.325,key:v,value:2.0，這些信息是從用戶的懇求信息里面解析出來的。錯誤碼code為530，表示這是調(diào)用商品的api所產(chǎn)生的錯誤。錯誤信息msg為Remote service error表示這是調(diào)用業(yè)務處置所產(chǎn)生的錯誤。子錯誤碼sub_code為：missing-parameter，表示這個錯誤是由于短少了參數(shù)所產(chǎn)生的。子錯誤信息sub_msg為：iid和num

12、_iid至少要傳入一個，表示少傳的參數(shù)為iid或num_iid。這一切的錯誤信息疊加起來可以知道，這個錯誤是用戶調(diào)用taobao.item.get接口時業(yè)務處置發(fā)現(xiàn)用戶沒有傳入商品id所導致的。3) 平臺解析錯誤平臺解析錯誤是指top前往的錯誤碼小于100的情況。平臺解析是非業(yè)務性的普適的校驗接入層，主要用于對用戶的各種權限、和入?yún)⑦M展最根本的校驗。如今的平臺錯誤碼主要有：Isv可以經(jīng)過錯誤碼和解釋來糾正問題。如：錯誤碼為3的呼應表示圖片上傳失敗，錯誤碼為26表示用戶沒有傳入session參數(shù)，錯誤碼為27表示用戶傳入的session參數(shù)找不到對應的session記錄，等等。4) 業(yè)務處置錯誤

13、業(yè)務處置錯誤是用戶經(jīng)過平臺校驗進入業(yè)務流程出現(xiàn)了錯誤所發(fā)出來的。這一層的錯誤碼根據(jù)調(diào)用版本不同分為兩種。假設版本是1.0，那么前往的錯誤信息格式就是：“error_rsp:“code:XXX,msg:，里面的code是數(shù)字方式的標志著一種錯誤的編碼，msg是字符串方式，標志在錯誤的詳細信息。如，獲取當商品失敗的錯誤信息就是：error_rsp:code:551,msg:Item service unavailable:獲取單個商品失敗。1.0的錯誤碼有以下幾種：1.0的前往的錯誤code就是其中的錯誤碼，錯誤msg就是其中的英文錯誤描畫加上詳細的錯誤信息組成的。假設版本是2.0，那么效力器所前

14、往的錯誤信息格式就是：“error_response:args:arg:“key:“ ,value: ,“key:“ ,value: ,“key:“ ,value: ,code: ,“msg: ,sub_code: ,sub_msg: ，里面的code是數(shù)字方式的標志著一種業(yè)務類型的錯誤編碼，msg那么是比較大范圍內(nèi)的表示錯誤類型的字符串。而sub_code是以字符串方式粗略表示錯誤的類型，sub_msg那么是表示詳細的錯誤緣由。2.0的code包含以下幾種分類：產(chǎn)品線錯誤碼用戶500類目510買賣520退款521商品530商品擴展API531郵費模板532產(chǎn)品540物流550店鋪560評價5

15、70淘寶客580系統(tǒng)590備案591增量API600比價610畫報620江湖630分銷640淘秀650收費660Misc(保證金等雜項api)670由上圖可知，每一大類的api在2.0中其實是共享一個code的，它能讓用戶在復雜組合調(diào)用中指點是哪一類的api出現(xiàn)了問題，實現(xiàn)初步的定位。2.0的業(yè)務錯誤中，msg里面最容易出現(xiàn)的內(nèi)容就是Remote service error，這表示用戶是在經(jīng)過了平臺校驗后進展業(yè)務流程的時候出現(xiàn)的錯誤。其他的錯誤還有Remote Service Timeout：后臺處置業(yè)務超時等等的錯誤。這一個錯誤信息的力度比較粗，很難單獨用她進展錯誤處置。2.0的業(yè)務處置錯誤

16、信息主要要看sub_code和sub_msg這連個字段。sub_code表示了效力費對業(yè)務錯誤的分類，sub_msg表示了是錯誤緣由。Sub_code根據(jù)業(yè)務錯誤類型主要可以分為如下幾類子錯誤碼錯誤歸類user-not-exist用戶不存在missing-parameter短少參數(shù)invalid-parameter參數(shù)錯誤parameters-mismatch參數(shù)不匹配主要針對那些需求一一對應的入?yún)nvalid-permission權限缺乏remote-service-error調(diào)用后端效力錯誤remote-service-timeout調(diào)用后端效力超時remote-connection-e

17、rror調(diào)用后端效力銜接錯誤XXX-service-unavailable調(diào)用后端效力失敗item-extra-not-exist商品擴展信息不存在trade-not-exist買賣記錄不存在refund-not-exist退款記錄不存在每一類的子錯誤碼代表著某一類型的錯誤，例如user-not-exist表示用戶傳入的nick或者用戶綁定的session所對應的nick找不到對應的用戶記錄，Invalid-permission表示用戶由于權限問題不能進展某些操作。sub_code給予isv或用戶以改良錯誤的方向，而sub_msg那么通知用戶改良點。例如sub_code為invalid-par

18、ameter，sub_msg為用戶傳入的iid不能超越40個，這就表示著，這次錯誤的緣由是用戶傳入的參數(shù)iid由于數(shù)量超越40個而產(chǎn)生了錯誤。錯誤呼應時用戶和效力器交互失敗的最直接展現(xiàn)，isv在調(diào)用top效力時，假設調(diào)用失敗，請盡量保管下錯誤信息建議盡量改用2.0調(diào)用，這個版本的錯誤信息比較全面，以便進展后面的錯誤清查。三、 呼應格式錯誤處置呼應格式錯誤是指用戶調(diào)用top效力時，傳入?yún)?shù)設置了format參數(shù)為json，但是接遭到的卻為xml的呼應格式，或者設置格式為xml接納到的卻為json呼應的格式的情況。普通正常情況下這種情況是不會出現(xiàn)的，但是還是會有一些異常的情況會引起這個問題。這種呼

19、應格式錯誤的問題在isv的程序中通常會表現(xiàn)為，呼應解析格式錯誤。例如：用戶運用的top的java SDK客戶端調(diào)用top效力，設置的format格式為json卻得到了一個xml的呼應，這是sdk就會報一個錯誤說呼應開場處短少一個“符號。這是由于xml呼應是以“開場的緣故。普通會發(fā)生這種景象的緣由有一下三種：用戶傳入的參數(shù)過大導致流解析異常，用戶調(diào)用太過頻繁道士呼應異常，top效力器缺點。為了定位到問題出在哪里，以便找到相應的處理方法，用戶在遇到呼應格式錯誤的情況時可以參考以下步驟進展調(diào)試。1. 呼應格式格式錯誤，但數(shù)據(jù)正確用戶第一步應該分析一下相應的內(nèi)容里面是不是除了格式錯誤以外，其他的呼應內(nèi)

20、容都是正確調(diào)用的前往結(jié)果。例如，有個用戶用top的sdk，設置format為json，調(diào)用top得到了這樣一個前往結(jié)果：com.taobao.api.json.JSONException:AJSONObjecttextmustbeginwithatcharacter111152021-03-0116:04:152021-03-0116:04:052021-03-0116:03:592021-03-0116:03:532021-03-0107:30:52從這個異常的開頭可以看到，這是sdk的json解析拋了一個異常，說呼應內(nèi)容的內(nèi)容應該是以“開場的。這說名，isv收到的呼應格式一定出了問題。再看

21、一下呼應的內(nèi)容相應結(jié)果標簽之間包含了totalResults和item列表，這些數(shù)聽闡明，這是調(diào)用商品查詢接口前往的結(jié)果數(shù)據(jù)：查詢到的結(jié)果總數(shù)是1115條，當前頁的商品iid和最近修正時間也在其中。這些查詢結(jié)果數(shù)據(jù)是正常的，但是前往格式卻不是傳入的json而是變成了xml。這位isv聯(lián)絡了top的技術支持，在建議減緩調(diào)用頻率以后，前往的數(shù)據(jù)格式正常了，這樣就暫時控制了這種情況的發(fā)生。同時技術支持將這些情況反映到了開發(fā)，top這邊后續(xù)就會找到問題根源，進一步杜絕這種情況的發(fā)生。2. 呼應格式錯誤，數(shù)據(jù)也錯誤假設用戶第一步分析發(fā)現(xiàn)，前往的信息并不是調(diào)用勝利的信息而是某個平臺錯誤，而且用戶本身的參數(shù)

22、并不會導致這個錯誤的產(chǎn)生，此時用戶就需求查看本人調(diào)用接口的參數(shù)了。假設用戶調(diào)用的接口需求傳入比較大的數(shù)據(jù)如：圖片、商品的長篇描畫等等，那么用戶應首先嘗試著減小這些入?yún)⒌胶戏ǚ秶鷥?nèi)輸入傳入小圖片或者之傳入少量的描畫文字等。假設用戶調(diào)用勝利，表示錯誤是由于用戶入?yún)⑻蠛浅饬私馕鲥e誤引起的，用戶應配合本人所在地方的網(wǎng)速，懇求大小等等的信息合理設置本人的參數(shù)大小和接口調(diào)用順序。假設用戶減小參數(shù)還是解析失敗的話，用戶嘗試著不傳入圖片或只傳入幾個字節(jié)的描畫的內(nèi)容進展接口調(diào)用。在傳入描畫只需很少的字節(jié)的情況下：假設不傳圖片調(diào)用勝利了，那么應該是top的效力器的問題，請將這個情況反響給技術支持進展處理；假設圖

23、片不傳調(diào)用依然失敗了，那么應該是用戶的調(diào)用參數(shù)或網(wǎng)絡有問題，請仔細對照文檔闡明對參數(shù)進展修正或等待網(wǎng)絡形狀好一點的時候進展調(diào)用?？偟膩碚f，假設用戶發(fā)生了呼應格式錯誤的情況，普通分為三種情況：用戶本身傳入的format就是錯誤的，這種情況用戶需求查看本人傳入的參數(shù)能否正確；用戶通訊的網(wǎng)絡太差，效力端呵斥懇求解析失敗而喪失了format信息，這種情況下用戶需求調(diào)整本人的網(wǎng)絡通訊情況，等情況恢復再調(diào)用；假設是其他由于圖片或調(diào)用太頻繁而引起的問題，用戶需求減小圖片或減緩調(diào)用來提高勝利率，并且將這些情況通報給top技術支持的同窗。四、 平臺級錯誤處置在前文的錯誤綜述中引見過，top的錯誤可以分為平臺級錯

24、誤和業(yè)務級錯誤。所謂平臺級錯誤就是指：錯誤碼小于100的調(diào)用錯誤。這種錯誤普通是由于用戶的懇求不符合各種的根本校驗而引起的。下面將對于各種平臺級錯誤及相應的處理方法陳列于此。錯誤碼錯誤解釋處理方法3圖片上傳失敗將傳入的圖片格式改為正確的格式、適當?shù)拇笮〉膱D片放進音訊體里面?zhèn)鬏斶^來。假設傳輸依然失敗需求減小圖片大小或者添加網(wǎng)絡帶寬進展嘗試4用戶調(diào)用次數(shù)超限調(diào)整程序邏輯合理利用api，等第二天再調(diào)用?；蛘呦蚣夹g運維的同窗懇求添加調(diào)用次數(shù)5會話調(diào)用次數(shù)超限6協(xié)作同伴調(diào)用次數(shù)超限7運用調(diào)用次數(shù)超限8運用調(diào)用頻率超限Isv調(diào)理api調(diào)用頻率，不能太過頻繁的調(diào)用9HTTP方法被制止請用大寫的POST或GE

25、T，假設有圖片等信息傳入那么一定要用POST才可以10效力不可用多數(shù)是由未知異常引起的，用戶仔細檢查本人傳入的參數(shù)能否符合文檔中描畫的樣子11開發(fā)者權限缺乏appKey所對應的運用不具備權限調(diào)用當前接口。需求聯(lián)絡運營或技術支持的同窗開通調(diào)用該接口的權限。12用戶權限缺乏13協(xié)作同伴權限缺乏15遠程效力出錯Api調(diào)用后端效力出錯，isv首先查看本人的參數(shù)能否合法，假設參數(shù)沒有問題請過一段時間再嘗試，假設還不行請聯(lián)絡技術支持21短少方法名參數(shù)傳入的參數(shù)參與method字段22不存在的方法名傳入的method字段必需是他所調(diào)用的api的稱號，并且該api是確實存在的23非法數(shù)據(jù)格式傳入的format

26、必需為json或xml中的一種24短少簽名參數(shù)傳入的參數(shù)中必需包含sign字段25非法簽名簽名必需根據(jù)正確的算法算出來的。算法請見： HYPERLINK open.taobao/dev/index.php/API%E7%AD%BE%E5%90%8D%E7%AE%97%E6%B3%95 open.taobao/dev/index.php/API簽名算法26短少SessionKey參數(shù)傳入的參數(shù)中必需包含session字段27非法的SessionKey參數(shù)傳入的session必需是用戶綁定session拿到的。假設報session不合法能夠是用戶沒有綁定session或session過期呵斥的，用

27、戶需求重新綁定一下然后傳入新的sessionKey。28短少AppKey參數(shù)傳入的參數(shù)必需包含app_key字段29非法的AppKey參數(shù)用戶傳入的appKey參數(shù)確實是要存在的，假設沒有懇求appKey的同窗請去懇求appKey，假設是曾經(jīng)有了appKey卻調(diào)用不同過的，請聯(lián)絡技術支持處理30短少時間戳參數(shù)傳入的參數(shù)中必需包含timestamp參數(shù)31非法的時間戳參數(shù)用戶傳入的時間戳不合法。時間戳，格式為yyyy-mm-dd hh:mm:ss，例如：2021-01-25 20:23:30。淘寶API效力端允許客戶端懇求時間誤差為10分鐘。32短少版本參數(shù)傳入的參數(shù)中必需包含v字段33非法的版

28、本參數(shù)用戶傳入的版本號格式錯誤，必需為數(shù)字格式34不支持的版本號用戶傳入的版本號沒有被提供。如今top只支持1.0或2.0兩種版本40短少必選參數(shù)用戶傳入的參數(shù)中漏掉了必傳的參數(shù)。請仔細對照文檔檢查41非法的參數(shù)用戶傳入的參數(shù)不符合文檔中闡明的參數(shù)格式，請參照文檔進展修正42懇求被制止懇求 被制止目前沒有在控制43參數(shù)錯誤參數(shù)解析發(fā)生錯誤或異常。普通是用戶傳入?yún)?shù)非法引起的。請仔細檢查入?yún)⒏袷健⒎秶?、能否一一對應等等情況。44Isp error后臺接入效力錯誤這種后臺效力異常引起的錯誤，請聯(lián)絡技術支持。根本上來說，平臺錯誤是一個通用的、普適的校驗。普通針對用戶的權限、平安、流量和最根本的參數(shù)等

29、等進展校驗。用戶遇到這些錯誤的前往一定要第一步檢查本人的權限、頻率等情況；然后就需求參照文檔檢驗一下本人的傳入的參數(shù)能否完好且合法；假設這些都無法處理問題，請聯(lián)絡技術支持的同窗進展反響，top后臺會盡快處理這些問題。五、 業(yè)務級錯誤處置業(yè)務級錯誤是指isv懇求進入top業(yè)務處置以后爆出來的業(yè)務相關的錯誤，通常錯誤碼分部在500-1000之間。Top的業(yè)務錯誤普通可以分為4個大類：參數(shù)錯誤、權限控制、用戶不存在和效力錯誤。1. 參數(shù)錯誤參數(shù)錯誤指topapi根據(jù)業(yè)務要求對用戶傳入的參數(shù)進展校驗組裝的時候產(chǎn)生的錯誤。1.0中的參數(shù)錯誤碼有： 505,Missing Parameters;506,P

30、arameters error;507,Parameters Format error和XXX,XXX not exist(這里XXX表示未知的數(shù)字或字符串)等等。其中：505表示短少傳入某些需求傳入的參數(shù)(如：獲取sku列表的時候要求至少傳入一個iid，isv卻什么都沒有傳入);506表示傳入的參數(shù)錯誤如：傳入的iid找到對應的商品已刪除、傳入的類目不存在等等；507表示用戶傳入的參數(shù)的格式不符合規(guī)定如：需求傳入數(shù)字的參數(shù)用戶傳入了非數(shù)字的字符；XXX not exist表示根據(jù)用戶指定的參數(shù)如：iid、tid等數(shù)據(jù)找不到對應的記錄，等等。2.0中的參數(shù)錯誤的錯誤碼是在調(diào)用前往的sub_co

31、de子錯誤碼里面得到詳細表達的。2.0的參數(shù)錯誤普通有如下幾個錯誤碼：missing-parameter，invalid-parameter，parameters-mismatch，XXX-not-exist等等。這幾種錯誤分別表示：missing-parameter表示短少了某些必傳參數(shù)如：獲取單個商品是iid和num_iid一個都沒傳入；invalid-parameter表示用戶傳入的參數(shù)錯誤如：傳入的iids個數(shù)不符合規(guī)定，傳入的iid對應的商品已刪除等等；parameters-mismatch表示用戶傳入的某些有對應關系的參數(shù)個數(shù)不匹配了如：input_pids和input_str長度

32、不匹配，或者sku_properties和sku的其他參數(shù)個數(shù)不匹配；XXX-not-exist表示用戶指定的參數(shù)找不到對應的記錄即這個參數(shù)所對應的記錄不存在或曾經(jīng)被刪除了。不論是1.0還是2.0的參數(shù)錯誤，都是由于isv傳入的參數(shù)有問題而引起的。用戶在遇到報參數(shù)錯誤的情況下，需求查看對應的錯誤音訊內(nèi)容1.0就是msg，2.0是sub_msg中的闡明來進展入?yún)⑿拚?。建議將這部分內(nèi)容展現(xiàn)給用戶，可以讓用直觀的看到錯誤的緣由，從而改良輸入。2. 權限控制權限控制的錯誤是指用戶運用了本人不享有的效力所呵斥的錯誤。這類型的錯誤：1.0的錯誤碼為：509,Permission limited；2.0的子

33、錯誤碼為：invalid-permission。這類型的錯誤通常都是用戶進展的操作觸碰到了淘寶的業(yè)務規(guī)那么，導致了top的業(yè)務校驗不經(jīng)過。如：用戶沒有登錄卻要獲取某個賣家倉庫中的商品，用戶不享有多圖效力卻要上傳商品多圖或商品屬性圖片，成人類目直接上傳圖片，修正自動發(fā)貨的商品，不是賣家或買家卻要獲取買賣詳細信息的這些錯誤并不是用戶傳入的參數(shù)找不到相應的數(shù)據(jù)、或者傳入的參數(shù)是錯誤的呵斥的。相反的，用戶傳入的參數(shù)都符合文檔描畫，但是用戶不具備權限來進展相應的操作。在這種情況下，isv有幾條路可以選擇。第一：對于查詢類型的權限控制：假設用戶是信息的一切者，那么需求讓用戶進展登錄綁定，這樣用戶就夠進展權

34、限控制的操作了；假設用戶不是信息的合法查看人，那么isv要明確的通知用戶這個操作不可以進展，并且不要進展重試操作了。第二：對于增刪改類型的操作的權限控制：假設用戶是由于沒有享有效力如：沒有享有圖片空間的效力而產(chǎn)生的權限限制，isv需求引導用戶去進展效力的開通后再來進展操作，之后再重新調(diào)用接口；假設是由于用戶操作了他人的數(shù)據(jù)而引起的權限控制，那么isv要明確的跟用戶報錯，并且不能再進展重試操作?？傊?，當用戶遇到報權限控制的錯誤時，isv不能直接進展重試。應該將問題直接通知用戶，并引導用戶進展相關的登錄、開通效力等操作來調(diào)整權限以后，再讓用戶重試操作。假設用戶不情愿進展調(diào)整，isv此時應該直接停頓

35、該操作，不能默許的進展重試，由于這種前提下，重試是完全沒有作用的。3. 用戶不存在用戶不存在是指top后臺根據(jù)用戶綁定的nick或者傳入的nick對用戶信息進展查詢的時候找不到用戶記錄所報出的錯誤。1.0的錯誤碼：601, User not exist；2.0的子錯誤碼：user-not-exist。用戶遇到這種問題首先請確認調(diào)用的這個接口本人有沒有傳入nick這個參數(shù)。假設nick是根據(jù)用戶綁定的session獲得的，那么用戶需求過一會兒再重新調(diào)用看看。假設隔一段時間還不行，請聯(lián)絡技術支持處理。假設用戶本人經(jīng)過參數(shù)傳入了nick，那么請用戶仔細檢查本人傳入的nick能否正確。例如：有沒有多一

36、個空格或者大小寫錯誤的？該用戶能否確實存在的？等等。假設問題是由于稱號錯誤或用戶確實不存在引起，用戶需求更改輸入?yún)?shù)后才干再次調(diào)用。假設用戶稱號正確，用戶也確實存在，卻還是報用戶不存在錯誤，用戶需求檢查傳入的nick能否包含難以識別的編碼的字體。假設nick中包含了火星文或者其他編碼的字體，請思索將nick轉(zhuǎn)換成utf8以后重新嘗試或者放棄此次操作。假設上述問題都不存在，請聯(lián)絡技術支持的同窗進展查看。整個查錯過程如下所示：4. 效力錯誤效力錯誤主要指用戶的懇求經(jīng)過了api業(yè)務的根本校驗，在調(diào)用后臺效力的時候由于出現(xiàn)了異常或者更提高的業(yè)務報錯而產(chǎn)生的錯誤。這一類錯誤主要分為3個大類：效力調(diào)用錯誤

37、、效力調(diào)用異常、遠程調(diào)用錯誤、top解析錯誤。a) 效力調(diào)用錯誤效力調(diào)用錯誤，是指經(jīng)過top校驗進入后端調(diào)用效力以后，由于不符合進一步的業(yè)務邏輯校驗而出現(xiàn)的錯誤。如：發(fā)布商品的屬性不符合商品類目的要求，評價的買賣曾經(jīng)過期等等。這些錯誤在1.0的錯誤前往錯誤碼為：XXX,XXX service error，在2.0的前往子錯誤碼為：XXX-service-error。用戶遇到這種前往闡明top的效力是正常的，是用戶的參數(shù)不合規(guī)定所引起。請根據(jù)前往的詳細msg和sub_msg內(nèi)容定位問題，然后矯正入?yún)⒑笤僬{(diào)用。假設確認參數(shù)錯誤卻不斷通不過調(diào)用，請聯(lián)絡技術支持的同窗咨詢情況，切勿盲目重試。b) 效力

38、調(diào)用異常效力調(diào)用異常是指效力調(diào)用過程中由于后端效力器沒有呼應或者產(chǎn)生了異?；蛘遲op效力本身產(chǎn)生了未被捕獲的異常而產(chǎn)生的錯誤。這些錯誤在1.0的錯誤前往錯誤碼為：XXX,XXX service unavailable，在2.0的前往子錯誤碼為：XXX-service-unavailable。這種錯誤有能夠是后端效力暫時不可用所引起的，所以用戶遇到這種錯誤時首先應該查看前往的錯誤信息里面有沒有有效的提示信息，假設有請先按照提示矯正問題再調(diào)用；假設沒有有效的提示信息，請等待一段時間再調(diào)用。假設不斷都是這個錯誤，請聯(lián)絡技術支持查看問題所在。切忌立刻反復重試。c) 遠程調(diào)用錯誤遠程調(diào)用錯誤是指top在

39、調(diào)用后方效力時發(fā)生了調(diào)用錯誤或超時的情況。這類錯誤能夠是由于后端效力過于忙碌或者效力失效引起的。這些錯誤在1.0的錯誤前往錯誤碼為：900,Remote Connection Error，901,Remote Service Timeout，902,Remote Service Error，在2.0的前往子錯誤碼為：remote-service-error，remote-service-timeout，remote-connection-error。用戶遇到這種情況，首先思索的是等待一段時間重試看效力能否恢復。假設效力曾經(jīng)恢復，那么這個只是短時間效力過于擁堵呵斥的；假設多次重試依然是不可用，那

40、么這個能夠是后端效力出了問題，請聯(lián)絡技術支持進展處置。d) Top解析錯誤Top解析錯誤目前主要針對的是用戶調(diào)用top效力時產(chǎn)生的未被捕獲的空指針或者參數(shù)轉(zhuǎn)換異常所產(chǎn)生的錯誤。這些錯誤是由于用戶的懇求有錯誤引發(fā)了top本身的效力流程的潛在隱患所引起的。1.0的錯誤前往錯誤碼為：510,Top parse error，在2.0的前往子錯誤碼為：top-parse-error。用戶遇到這種問題時，請先仔細檢查本人的參數(shù)，根據(jù)文檔闡明修正完善以后再嘗試調(diào)用，普通正常情況，只需入?yún)⒑戏ㄊ强梢詣倮?。假設確定參數(shù)正確的前提下還是調(diào)用報這個錯誤，請聯(lián)絡技術支持的同窗反響這個問題。六、 前往參數(shù)缺失處置前往

41、參數(shù)缺失是指用戶調(diào)用api前往勝利，但是音訊體里面的內(nèi)容和所懇求的內(nèi)容不一致的情況。這種情況細分可以分為三種情況：整個音訊體為空、音訊體短少文檔定義的構造前往、前往的構造體中短少fields指定的某些字段的前往。1. 整個音訊體為空或短少文檔中闡明的構造體前往。整個音訊體為空或短少文檔中闡明的構造體是指：前往結(jié)果是非失敗的情況下，得到的Response的body內(nèi)容和文檔定義不一致比文檔寫到要短少某些內(nèi)容的情況。例如：調(diào)用新增商品接口，正常的前往結(jié)果1.0是：rsp:items:created:2021-11-17 16:30:50,iid:cbf8d5d64b3fc80b25d21b1e1c88fd41。2.0的前往結(jié)果是：item_add_response:item:iid:699e0a75fcea3966d1d57fc8278c674b,created:2021-10-22 15:08:42。根據(jù)文檔的闡明：添加商品勝利的前往構造體中包含的數(shù)據(jù)就是這樣。以此種前往結(jié)果舉例，整個音訊體為空的情況是指前往的結(jié)果為： 或item_add_response: 。這個音訊體里面什么東西都沒有，既沒有報錯的信息，也沒有