錯(cuò)誤診斷說(shuō)明

（企業(yè)診斷）錯(cuò)誤診斷說(shuō)明1xx：信息，請(qǐng)求收到，繼續(xù)處理2xx：成功，行為被成功地接受、理解和采納3xx：重定向，為了完成請(qǐng)求，必須進(jìn)一步執(zhí)行的動(dòng)作4xx：客戶端錯(cuò)誤，請(qǐng)求包含語(yǔ)法錯(cuò)誤或者請(qǐng)求無(wú)法實(shí)現(xiàn)5xx：服務(wù)器錯(cuò)誤，服務(wù)器不能實(shí)現(xiàn)一種明顯無(wú)效的請(qǐng)求Isv調(diào)用top服務(wù)最常收到就是200http404500內(nèi)部服404top被和諧了……如果用戶收到的響應(yīng)碼是500，表示網(wǎng)絡(luò)是ok的，是top的服務(wù)無(wú)法響應(yīng)。2)服務(wù)端錯(cuò)誤總述平臺(tái)解析錯(cuò)誤和業(yè)務(wù)處理錯(cuò)誤都是http成功訪問(wèn)到top服務(wù)（http響應(yīng)碼返回為200）之后所產(chǎn)生的錯(cuò)信息，他們top處理isv請(qǐng)求過(guò)程中出現(xiàn)的問(wèn)題。1.0和2.0的格式有所不同。1.0的錯(cuò)誤響應(yīng)信息最外層為表示這是調(diào)用錯(cuò)誤所返回的信息。里面一層包含兩個(gè)元素：”code”:””和“msg”:””，前者表示錯(cuò)1.0的.get服務(wù)錯(cuò)誤時(shí)返回的錯(cuò)誤信息：{"error_rsp":{"code":40,"msg":"Missingrequiredarguments:missingparameteriid/num_iid"}}。這個(gè)信息的開(kāi)頭為error_rsp，表示這是調(diào)用錯(cuò)誤所返回的結(jié)果。里面包含的錯(cuò)誤體的code為40msg內(nèi)容為Missingrequiredarguments:missingparameteriid/num_iid必傳參數(shù)是iid或者num_iid。Isv解析到這些信息后就需要根據(jù)錯(cuò)誤信息改進(jìn)自己傳入的參數(shù)來(lái)使調(diào)用成功。2.0的錯(cuò)誤響應(yīng)信息的最外層為服務(wù)失敗所返回的錯(cuò)誤信息。信息體里面一層總共包含了五個(gè)元素："args":{"arg":[{“key”:“”,”value”:””},{“key”:“”,”value”:””},{“key”:“”,”value”:””}……]}，”code”:””，“msg”:””，”sub_code”:””和”sub_msg”:””。args表示用戶傳入的argargkeyvaluecode表示用戶調(diào)用錯(cuò)誤的錯(cuò)誤碼是多少，小于200表示平臺(tái)級(jí)錯(cuò)誤，200-1000api調(diào)用發(fā)生了錯(cuò)誤（根據(jù)apiapi是530，交易類的api是520，等）；msg表示大類型的錯(cuò)誤碼所對(duì)應(yīng)的錯(cuò)誤信息，一般不具備獨(dú)立的debug作用，需要和sub_code和sub_msg一起使用才行；sub_code是調(diào)用錯(cuò)誤的子錯(cuò)誤碼，他表示用戶調(diào)用錯(cuò)誤的原因；sub_msg是子錯(cuò)誤碼所對(duì)應(yīng)的錯(cuò)誤信息，他用2.0的.get服務(wù)錯(cuò)誤時(shí)返回的錯(cuò)誤信息：{"error_response":{"args":{"arg":[{"key":"app_key","value":"15739"},{"key":"fields","value":"list_time,delist_time,approve_status"},{"key":"format","value":"json"},{"key":"method","value":".get"},{"key":"nick","value":"tbtest561"},{"key":"partner_id","value":"TOPTEST"},{"key":"sign","value":"668FB4A049F71A1C845EF8C05B1F3E66"},{"key":"timestamp","value":"2010-03-0518:03:06.325"},{"key":"v","value":"2.0"}]},"code":530,"msg":"Remoteserviceerror","sub_code":"missing-parameter","sub_msg":"iid和num_iid至少要傳入一個(gè)"}}這個(gè)信息的開(kāi)頭為error_response的args列出了用調(diào)用這個(gè)接口傳入的信息有：[{"key":"app_key","value":"15739"},{"key":"fields","value":"list_time,delist_time,approve_status"},{"key":"format","value":"json"},{"key":"method","value":".get"},{"key":"nick","value":"tbtest561"},{"key":"partner_id","value":"TOPTEST"},{"key":"sign","value":"668FB4A049F71A1C845EF8C05B1F3E66"},{"key":"timestamp","value":"2010-03-0518:03:06.325"},{"key":"v","value":"2.0"}]，這些信息是從用戶的請(qǐng)求信息里面解析出來(lái)的。錯(cuò)誤碼code為530，表示這是調(diào)用商品的api所產(chǎn)生的錯(cuò)誤。錯(cuò)誤信息msg為Remoteserviceerror表示這是調(diào)用業(yè)務(wù)處理所產(chǎn)生的錯(cuò)誤。子錯(cuò)誤碼sub_code為：missing-parameter，表示這個(gè)錯(cuò)誤是因?yàn)槿鄙倭藚?shù)所產(chǎn)生的。子錯(cuò)誤信息sub_msgiid和num_iidiid或num_iid。.get接口時(shí)業(yè)務(wù)處理發(fā)現(xiàn)用戶沒(méi)有傳入商品id所導(dǎo)致的。3)平臺(tái)解析錯(cuò)誤平臺(tái)解析錯(cuò)誤是指top返回的錯(cuò)誤碼小于100的情況。平臺(tái)解析是非業(yè)務(wù)性的普適的校驗(yàn)接入層，主要用于對(duì)用戶的各種權(quán)限、和入?yún)⑦M(jìn)行最基本的校驗(yàn)。現(xiàn)在的平臺(tái)錯(cuò)誤碼主要有：Isv可以通過(guò)錯(cuò)誤碼和解釋來(lái)糾正問(wèn)題。如：錯(cuò)誤碼為3的響應(yīng)表示圖片上傳失26表示用戶沒(méi)有傳入session27表示用戶傳入的session參數(shù)找不到對(duì)應(yīng)的session記錄，等等。4)業(yè)務(wù)處理錯(cuò)誤業(yè)務(wù)處理錯(cuò)誤是用戶通過(guò)平臺(tái)校驗(yàn)進(jìn)入業(yè)務(wù)流程出現(xiàn)了錯(cuò)誤所發(fā)出來(lái)的。這一層的錯(cuò)誤碼根據(jù)調(diào)用版本不同分為兩種。如果版本是1.0，那么返回的錯(cuò)誤信code是數(shù)字形式的標(biāo)記著一種錯(cuò)誤的編碼，msg是字符串形式，標(biāo)記在錯(cuò)誤的具體信息。如，獲取當(dāng)商品失敗的錯(cuò)誤信息就是：{"error_rsp":{"code":551,"msg":"Itemserviceunavailable:獲取單個(gè)商品失敗"}}。1.0的錯(cuò)誤碼有以下幾種：1.0的返回的錯(cuò)誤codemsg就是其中的英文錯(cuò)誤描述加上具體的錯(cuò)誤信息組成的。如果版本是2.0，那么服務(wù)器所返回的錯(cuò)誤信息格式就是：{“error_response”:{"args":{"arg":[{“key”:“”,”value”:””},{“””,“msg”:””,”sub_code”:””,”sub_msg”:””}}，里面的code是數(shù)字形式的標(biāo)記著一種業(yè)務(wù)類型的錯(cuò)誤編碼，msg則是比較大范圍內(nèi)的表示錯(cuò)誤sub_codesub_msg則是表示具體的錯(cuò)誤原因。2.0的code包含以下幾種分類：產(chǎn)品線錯(cuò)誤碼用戶500類目510交易520退款521商品530商品擴(kuò)展API531郵費(fèi)模板532產(chǎn)品540物流550店鋪560評(píng)價(jià)570淘寶客580系統(tǒng)590備案591增量API600比價(jià)610畫報(bào)620江湖630分銷640淘秀650收費(fèi)660Misc(保證金等雜項(xiàng)api)670由上圖可知，每一大類的api在2.0中其實(shí)是共享一個(gè)code的，它能讓用戶在復(fù)雜組合調(diào)用中指導(dǎo)是哪一類的api出現(xiàn)了問(wèn)題，實(shí)現(xiàn)初步的定位。2.0的業(yè)務(wù)錯(cuò)誤中，msg里面最容易出現(xiàn)的內(nèi)容就是Remoteserviceerror，還有RemoteServiceTimeout力度比較粗，很難單獨(dú)用她進(jìn)行錯(cuò)誤處理。2.0的業(yè)務(wù)處理錯(cuò)誤信息主要要看sub_code和sub_msg這連個(gè)字段。sub_code表示了服務(wù)費(fèi)對(duì)業(yè)務(wù)錯(cuò)誤的分類，sub_msg表示了是錯(cuò)誤原因。Sub_code根據(jù)業(yè)務(wù)錯(cuò)誤類型主要可以分為如下幾類子錯(cuò)誤碼錯(cuò)誤歸類user-not-exist用戶不存在missing-parameter缺少參數(shù)invalid-parameter參數(shù)錯(cuò)誤parameters-mismatch參數(shù)不匹配（主要針對(duì)那些需要一一對(duì)應(yīng)的入?yún)ⅲ㊣nvalid-permission權(quán)限不足remote-service-error調(diào)用后端服務(wù)錯(cuò)誤remote-service-timeout調(diào)用后端服務(wù)超時(shí)remote-connection-error調(diào)用后端服務(wù)連接錯(cuò)誤XXX-service-unavailable調(diào)用后端服務(wù)失敗item-extra-not-exist商品擴(kuò)展信息不存在trade-not-exist交易記錄不存在refund-not-exist退款記錄不存在每一類的子錯(cuò)誤碼代表著某一類型的錯(cuò)誤，例如user-not-exist表示用戶傳入的nick或者用戶綁定的session所對(duì)應(yīng)的nick找不到對(duì)應(yīng)的用戶記錄，Invalid-permission表示用戶由于權(quán)限問(wèn)題不能進(jìn)行某些操作。sub_code給予isv或用戶以改進(jìn)錯(cuò)誤的方向，而sub_msg則告訴用戶改進(jìn)點(diǎn)。例如sub_code為invalid-parametersub_msg為用戶傳入的iid不能超過(guò)40這次錯(cuò)誤的原因是用戶傳入的參數(shù)iid由于數(shù)量超過(guò)40個(gè)而產(chǎn)生了錯(cuò)誤。錯(cuò)誤響應(yīng)時(shí)用戶和服務(wù)器交互失敗的最直接展示，isv在調(diào)用top服務(wù)時(shí)，2.0誤信息比較全面），以便進(jìn)行后面的錯(cuò)誤追查。三、響應(yīng)格式錯(cuò)誤處理響應(yīng)格式錯(cuò)誤是指用戶調(diào)用top服務(wù)時(shí)，傳入?yún)?shù)設(shè)置了format參數(shù)為jsonxmlxml接收到的卻為jsonisv的程序中通常會(huì)表top的javaSDK客戶端調(diào)用top服format格式為json卻得到了一個(gè)xmlsdk就會(huì)報(bào)一個(gè)“{”xml響應(yīng)是以“<”開(kāi)始的緣故。一般會(huì)發(fā)生這種現(xiàn)象的原因有一下三種：用戶傳入的參數(shù)過(guò)大導(dǎo)致流解析異常，用戶調(diào)用太過(guò)頻繁道士響應(yīng)異常，top服務(wù)器故障。為了定位到問(wèn)題出在哪里，以便找到相應(yīng)的解決方法，用戶在遇到響應(yīng)格式錯(cuò)誤的情況時(shí)可以參考以下步驟進(jìn)行調(diào)試。1.響應(yīng)格式格式錯(cuò)誤，但數(shù)據(jù)正確用戶第一步應(yīng)該分析一下相應(yīng)的內(nèi)容里面是不是除了格式錯(cuò)誤以外，其他的響應(yīng)內(nèi)容都是正確調(diào)用的返回結(jié)果。top的sdkformat為jsontop得到了這樣一個(gè)返回結(jié)果：..JSONException:AJSONObjecttextmustbeginwith'{'atcharacter1<?xmlversion="1.0"encoding="utf-8"?><rsp><totalResults>1115</totalResults><item><iid><![CDATA[77a003aef35f8d959eef03d7ba3d23e3]]></iid><modified>2010-03-0116:04:15</modified></item><item><iid><![CDATA[c559afab73ab721a8e7500b62864add0]]></iid><modified>2010-03-0116:04:05</modified></item><item><iid><![CDATA[28a3410c88bc2bace8891eaf7]]></iid><modified>2010-03-0116:03:59</modified></item><item><iid><![CDATA[915383f4733b7a7c2549aa863d305995]]></iid><modified>2010-03-0116:03:53</modified></item>……<item><iid><![CDATA[528223dc2d67213aa29ab84c74c6a60a]]></iid><modified>2010-03-0107:30:52</modified></item></rsp>sdk的json容的內(nèi)容應(yīng)該是以“{”開(kāi)始的。這說(shuō)名，isv收到的響應(yīng)格式肯定出了問(wèn)題。<rsp></rsp>相應(yīng)結(jié)果標(biāo)簽之間包含了totalResults和item果總數(shù)是1115條，當(dāng)前頁(yè)的商品iid和最近修改時(shí)間也在其中。這些查詢結(jié)果json而是變成了xmlisv聯(lián)系了top臨時(shí)控制了這種情況的發(fā)生。同時(shí)技術(shù)支持將這些情況反映到了開(kāi)發(fā)，top這邊后續(xù)就會(huì)找到問(wèn)題根源，進(jìn)一步杜絕這種情況的發(fā)生。2.響應(yīng)格式錯(cuò)誤，數(shù)據(jù)也錯(cuò)誤如果用戶第一步分析發(fā)現(xiàn)，返回的信息并不是調(diào)用成功的信息而是某個(gè)平臺(tái)己調(diào)用接口的參數(shù)了。如果用戶調(diào)用的接口需要傳入比較大的數(shù)據(jù)（如：圖片、商品的長(zhǎng)篇描述等合理設(shè)置自己的參數(shù)大小和接口調(diào)用順序。如果用戶減小參數(shù)還是解析失敗的話，用戶嘗試著不傳入圖片或只傳入幾個(gè)字節(jié)的描述的內(nèi)容進(jìn)行接口調(diào)用。在傳入描述只有很少的字節(jié)的情況下：如果不傳圖片調(diào)用成功了，那么應(yīng)該是top的服務(wù)器的問(wèn)題，請(qǐng)將這個(gè)情況反饋給技術(shù)支持進(jìn)行解決；如果圖片不傳調(diào)用仍然失敗了，那么應(yīng)該是用戶的調(diào)用參數(shù)或網(wǎng)絡(luò)有問(wèn)題，請(qǐng)仔細(xì)對(duì)照文檔說(shuō)明對(duì)參數(shù)進(jìn)行修改或等待網(wǎng)絡(luò)狀態(tài)好一點(diǎn)的時(shí)候進(jìn)行調(diào)用。總的來(lái)說(shuō)，如果用戶發(fā)生了響應(yīng)格式錯(cuò)誤的情況，一般分為三種情況：用戶本身傳入的format就是錯(cuò)誤的，這種情況用戶需要查看自己傳入的參數(shù)是否正確；用戶通信的網(wǎng)絡(luò)太差，服務(wù)端造成請(qǐng)求解析失敗而丟失了format信息，這并且將這些情況通報(bào)給top技術(shù)支持的同學(xué)。四、平臺(tái)級(jí)錯(cuò)誤處理top的錯(cuò)誤可以分為平臺(tái)級(jí)錯(cuò)誤和業(yè)務(wù)級(jí)錯(cuò)誤。100的調(diào)用錯(cuò)誤。這種錯(cuò)誤一般是由于用戶決辦法陳列于此。錯(cuò)誤碼錯(cuò)誤解釋解決辦法3圖片上傳失敗傳輸仍然失敗需要減小圖片大小或者增加網(wǎng)絡(luò)帶寬進(jìn)行嘗試4用戶調(diào)用次數(shù)超限調(diào)整程序邏輯合理利用api，等第二天再調(diào)5會(huì)話調(diào)用次數(shù)超限6合作伙伴調(diào)用次數(shù)超限數(shù)7應(yīng)用調(diào)用次數(shù)超限8應(yīng)用調(diào)用頻率超限Isv調(diào)節(jié)api調(diào)用頻率，不能太過(guò)頻繁的調(diào)用9HTTP方法被禁止請(qǐng)用大寫的POST或GET傳入則一定要用POST才可以10服務(wù)不可用己傳入的參數(shù)是否符合文檔中描述的樣子11開(kāi)發(fā)者權(quán)限不足appKey所對(duì)應(yīng)的應(yīng)用不具備權(quán)限調(diào)用當(dāng)前12用戶權(quán)限不足13合作伙伴權(quán)限不足調(diào)用該接口的權(quán)限。15遠(yuǎn)程服務(wù)出錯(cuò)Api調(diào)用后端服務(wù)出錯(cuò)，isv首先查看自己21缺少方法名參數(shù)傳入的參數(shù)加入method字段22不存在的方法名傳入的method字段必需是你所調(diào)用的api的名稱，并且該api是確實(shí)存在的23非法數(shù)據(jù)格式傳入的format必需為json或xml中的一種24缺少簽名參數(shù)傳入的參數(shù)中必需包含sign字段25非法簽名見(jiàn)：./API簽名算法26缺少SessionKey參數(shù)傳入的參數(shù)中必需包含session字段27非法的SessionKey參數(shù)傳入的session必需是用戶綁定session拿session不合法可能是用戶沒(méi)有綁定session或session戶需要重新綁定一下然后傳入新的sessionKey。28缺少AppKey參數(shù)傳入的參數(shù)必需包含app_key字段29非法的AppKey參數(shù)用戶傳入的appKey參數(shù)確實(shí)是要存在的，如果沒(méi)有申請(qǐng)appKey的同學(xué)請(qǐng)去申請(qǐng)appKey，如果是已經(jīng)有了appKey卻調(diào)用不同過(guò)的，請(qǐng)聯(lián)系技術(shù)支持解決30缺少時(shí)間戳參數(shù)傳入的參數(shù)中必需包含timestamp參數(shù)31非法的時(shí)間戳參數(shù)yyyy-mm-ddhh:mm:ss2008-01-2520:23:30。淘寶API服務(wù)端允許客戶端請(qǐng)求時(shí)間誤差為10分鐘。32缺少版本參數(shù)傳入的參數(shù)中必需包含v字段33非法的版本參數(shù)式34不支持的版本號(hào)top只支持1.0或2.0兩種版本40缺少必選參數(shù)細(xì)對(duì)照文檔檢查41非法的參數(shù)用戶傳入的參數(shù)不符合文檔中說(shuō)明的參數(shù)格式，請(qǐng)參照文檔進(jìn)行修改42請(qǐng)求被禁止請(qǐng)求被禁止（目前沒(méi)有在控制）43參數(shù)錯(cuò)誤圍、是否一一對(duì)應(yīng)等等情況。44Isperror后臺(tái)接入服務(wù)錯(cuò)誤支持?；旧蟻?lái)說(shuō)，平臺(tái)錯(cuò)誤是一個(gè)通用的、普適的校驗(yàn)。一般針對(duì)用戶的權(quán)限、top后臺(tái)會(huì)盡快解決這些問(wèn)題。五、業(yè)務(wù)級(jí)錯(cuò)誤處理業(yè)務(wù)級(jí)錯(cuò)誤是指isv請(qǐng)求進(jìn)入top業(yè)務(wù)處理以后爆出來(lái)的業(yè)務(wù)相關(guān)的錯(cuò)誤，通常錯(cuò)誤碼分部在500-1000之間。Top的業(yè)務(wù)錯(cuò)誤一般可以分為4錯(cuò)誤、權(quán)限控制、用戶不存在和服務(wù)錯(cuò)誤。1.參數(shù)錯(cuò)誤參數(shù)錯(cuò)誤指topapi根據(jù)業(yè)務(wù)要求對(duì)用戶傳入的參數(shù)進(jìn)行校驗(yàn)組裝的時(shí)候產(chǎn)生的錯(cuò)誤。1.0中的參數(shù)錯(cuò)誤碼有：505,"MissingParameters";506,"Parameterserror";507,"ParametersFormaterror"和這里XXX表示未知的數(shù)字或字符串)505表示缺少傳入某些需要傳入的參數(shù)(如：獲取sku列表的時(shí)候要求至少傳入一個(gè)iid，isv卻什么都沒(méi)有傳入);506iid找到對(duì)應(yīng)的商品已刪除、傳入的類目不存在等等）；507表示用戶傳入的參數(shù)的格式不符合規(guī)定（如：需要傳入數(shù)字的參數(shù)用戶傳入了非數(shù)字的字符）；XXXnotexist表示根據(jù)用戶指定的參數(shù)（如：iid、tid等數(shù)據(jù)）找不到對(duì)應(yīng)的記錄，等等。2.0中的參數(shù)錯(cuò)誤的錯(cuò)誤碼是在調(diào)用返回的sub_code子錯(cuò)誤碼里面得到具體體現(xiàn)的。2.0的參數(shù)錯(cuò)誤一般有如下幾個(gè)錯(cuò)誤碼：missing-parameter，invalid-parameter，parameters-mismatch，XXX-not-exist等等。這幾種錯(cuò)誤missing-parameteriid和num_iidinvalid-parameter傳入的iids個(gè)數(shù)不符合規(guī)定，傳入的iid對(duì)應(yīng)的商品已刪除等等）；parameters-mismatchinput_pids和input_str長(zhǎng)度不匹配，或者sku_properties和sku的其他參數(shù)個(gè)數(shù)不匹配）；XXX-not-exist表示用戶指定的參數(shù)找不到對(duì)應(yīng)的記錄（即這個(gè)參數(shù)所對(duì)應(yīng)的記錄不存在或已經(jīng)被刪除了）。不管是1.0還是2.0isv傳入的參數(shù)有問(wèn)題而引起的。1.0就是msg，2.0是sub_msg）中的說(shuō)明來(lái)進(jìn)行入?yún)⑿薷?。建議將這部分內(nèi)容展示給用戶，可以讓用直觀的看到錯(cuò)誤的原因，從而改進(jìn)輸入。2.權(quán)限控制權(quán)限控制的錯(cuò)誤是指用戶使用了自己不享有的服務(wù)所造成的錯(cuò)誤。這類型的錯(cuò)誤：1.0的錯(cuò)誤碼為：509,"Permissionlimited"；2.0的子錯(cuò)誤碼為：invalid-permission務(wù)規(guī)則，導(dǎo)致了top直接上傳圖片，修改自動(dòng)發(fā)貨的商品，不是賣家或買家卻要獲取交易詳細(xì)信息進(jìn)行相應(yīng)的操作。在這種情況下，isv有幾條路可以選擇。第一：對(duì)于查詢類型的權(quán)限控制：isv要明確的告訴用戶產(chǎn)生的權(quán)限限制，isv需要引導(dǎo)用戶去進(jìn)行服務(wù)的開(kāi)通后再來(lái)進(jìn)行操作，之后再重新調(diào)用接口；如果是因?yàn)橛脩舨僮髁藙e人的數(shù)據(jù)而引起的權(quán)限控制，那么isv要明確的跟用戶報(bào)錯(cuò)，并且不能再進(jìn)行重試操作。總之，當(dāng)用戶遇到報(bào)權(quán)限控制的錯(cuò)誤時(shí)，isv不能直接進(jìn)行重試。應(yīng)該將問(wèn)再讓用戶重試操作。如果用戶不愿意進(jìn)行調(diào)整，isv此時(shí)應(yīng)該直接停止該操作，不能默認(rèn)的進(jìn)行重試，因?yàn)檫@種前提下，重試是完全沒(méi)有作用的。3.用戶不存在用戶不存在是指top后臺(tái)根據(jù)用戶綁定的nick或者傳入的nick對(duì)用戶信息進(jìn)行查詢的時(shí)候找不到用戶記錄所報(bào)出的錯(cuò)誤。1.0的錯(cuò)誤碼：601,"Usernotexist"；2.0的子錯(cuò)誤碼：user-not-exist。用戶遇到這種問(wèn)題首先請(qǐng)確認(rèn)調(diào)用的這個(gè)接口自己有沒(méi)有傳入nick這個(gè)參數(shù)。如果nick是根據(jù)用戶綁定的session取得的，那么用戶需要過(guò)一會(huì)兒再重新調(diào)用看看。如果隔一段時(shí)間還不行，請(qǐng)聯(lián)系技術(shù)支持解決。如果用戶自己通過(guò)參數(shù)傳入了nick，那么請(qǐng)用戶仔細(xì)檢查自己傳入的nick后才能再次調(diào)用。如果用戶名稱正確，用戶也確實(shí)存在，卻還是報(bào)用戶不存在錯(cuò)誤，用戶需要檢查傳入的nicknick中包含了火星文或nick轉(zhuǎn)換成utf8以后重新嘗試或者放棄此次操作。如果上述問(wèn)題都不存在，請(qǐng)聯(lián)系技術(shù)支持的同學(xué)進(jìn)行查看。整個(gè)查錯(cuò)過(guò)程如下所示：4.服務(wù)錯(cuò)誤服務(wù)錯(cuò)誤主要指用戶的請(qǐng)求通過(guò)了api業(yè)務(wù)的基本校驗(yàn)，在調(diào)用后臺(tái)服務(wù)的3個(gè)大類：服務(wù)調(diào)用錯(cuò)誤、服務(wù)調(diào)用異常、遠(yuǎn)程調(diào)用錯(cuò)誤、top解析錯(cuò)誤。a)服務(wù)調(diào)用錯(cuò)誤服務(wù)調(diào)用錯(cuò)誤，是指通過(guò)top校驗(yàn)進(jìn)入后端調(diào)用服務(wù)以后，由于不符合進(jìn)一步的業(yè)務(wù)邏輯校驗(yàn)而出現(xiàn)的錯(cuò)誤。如：發(fā)布商品的屬性不符合商品類目的要求，評(píng)價(jià)的交易已經(jīng)過(guò)期等等。這些錯(cuò)誤在1.0的錯(cuò)誤返回錯(cuò)誤碼為：XXX,”XXXserviceerror”，在2.0的返回子錯(cuò)誤碼為：XXX-service-error。用戶遇到這種返回表明top請(qǐng)根據(jù)返回的具體msg和sub_msg試。b)服務(wù)調(diào)用異常服務(wù)調(diào)用異常是指服務(wù)調(diào)用過(guò)程中由于后端服務(wù)器沒(méi)有響應(yīng)或者產(chǎn)生了異常或者top1.0的錯(cuò)誤返回錯(cuò)誤碼為：XXX,”XXXserviceunavailable”，在2.0的返回子錯(cuò)誤碼為：XXX-service-unavailable。這種錯(cuò)誤有可能是后端服務(wù)暫時(shí)不可用所引起的，所以用戶遇到這種錯(cuò)誤時(shí)都是這個(gè)錯(cuò)誤，請(qǐng)聯(lián)系技術(shù)支持查看問(wèn)題所在。切忌立即反復(fù)重試。c)遠(yuǎn)程調(diào)用錯(cuò)誤遠(yuǎn)程調(diào)用錯(cuò)誤是指top在調(diào)用后方服務(wù)時(shí)發(fā)生了調(diào)用錯(cuò)誤或超時(shí)的情況。這1.0的錯(cuò)誤返回錯(cuò)誤碼為：900,"RemoteConnectionError"，901,"RemoteServiceTimeout"，902,"RemoteServiceError"，在2.0的返回子錯(cuò)誤碼為：remote-service-error，remote-service-timeout，remote-connection-error。用戶遇到這種情況，首先考慮的是等待一段時(shí)間重試看服務(wù)是否恢復(fù)。如果可用，那么這個(gè)可能是后端服務(wù)出了問(wèn)題，請(qǐng)聯(lián)系技術(shù)支持進(jìn)行處理。d)Top解析錯(cuò)誤Top解析錯(cuò)誤目前主要針對(duì)的是用戶調(diào)用top服務(wù)時(shí)產(chǎn)生的未被捕獲的空指針或者參數(shù)轉(zhuǎn)換異常所產(chǎn)生的錯(cuò)誤。這些錯(cuò)誤是由于用戶的請(qǐng)求有錯(cuò)誤引發(fā)了top本身的服務(wù)流程的潛在隱患所引起的。1.0的錯(cuò)誤返回錯(cuò)誤碼為：510,"Topparseerror"，在2.0的返回子錯(cuò)誤碼為：top-parse-error。用戶遇到這種問(wèn)題時(shí)，請(qǐng)先仔細(xì)檢查自己的參數(shù)，根據(jù)文檔說(shuō)明修改完善以的前提下還是調(diào)用報(bào)這個(gè)錯(cuò)誤，請(qǐng)聯(lián)系技術(shù)支持的同學(xué)反饋這個(gè)問(wèn)題。六、返回參數(shù)缺失處理返回參數(shù)缺失是指用戶調(diào)用api返回成功，但是消息體里面的內(nèi)容和所請(qǐng)求體缺少文檔定義的結(jié)構(gòu)返回、返回的結(jié)構(gòu)體中缺少fields指定的某些字段的返回。1.整個(gè)消息體為空或缺少文檔中說(shuō)明的結(jié)構(gòu)體返回。整個(gè)消息體為空或缺少文檔中說(shuō)明的結(jié)構(gòu)體是指：返回結(jié)果是非失敗的情況Response的body內(nèi)容和文檔定義不一致（比文檔寫到要缺少某些內(nèi)容）的情況。例如：調(diào)用新增商品接口，正常的返回結(jié)果1.0是：{"rsp":{"items":[{"created":"2009-11-1716:30:50","iid":"cbf8d5d64b3fc80b25d21b1e1c88fd41"}]}}。2.0的返回結(jié)果是：{"item_add_response":{"item":{"iid":"699e0a75fcea39