《top错误诊断说明》由会员分享，可在线阅读，更多相关《top错误诊断说明（26页珍藏版）》请在金锄头文库上搜索。
1、Evaluation Warning: The document was created with Spire.Doc for .NET.一、 错误处理流程概览从这个错误处理流程可知，在整个错误处理的过程中，一共可以分为3条主要的流程：请求解析异常流程处理，平台级错误处理和业务调用错误处理。当然，这一切处理的最初也是最重要的一步就是：将服务器响应内容保留下来。二、 服服务器响响应内容容透析服务器响应应内容，顾顾名思义义就是iisv调调用toop服务务得到的的响应的的内容。这这些内容容能够最最真实的的反应出出isvv请求的的问题和和服务器器当前的的情况，也也最能够够帮助iisv找找到问题题的所在
2、在。服务器响应应内容一一般分为为两种：一种是是wikki文档档中所编编写的成成功调用用所返回回的字段段，另一一种是调调用失败败的返回回的错误误相关信信息。1. 调调用成功功返回格格式调用成功的的响应信信息内容容根据调调用服务务版本的的不同分分为了两两种不同同的格式式。1.0的服服务返回回信息的的格式分分为三层层：最外外一层是是rssp: 标记，表表示这是是服务的的响应内内容；中中间一层层是返回回结构体体的标记记，如：返回的的是商品品的结构构体，中中间这层层就是iteems: , ，表示示结果是是一个商商品的列列表，如如果返回回参数不不是以结结构体的的形式，这这一层就就不存在在；最内内一层就就是
3、每个个结构体体具体的的字段了了。1.0这个个版本所所有返回回结果，不不论是单单个的商商品还是是一个商商品列表表，他的的第二层层都是一一个列表表的结构构，区别别只是列列表里有有一个子子结构体体还是有有多个子子结构体体而已。相比之下，2.0的服务返回信息就相对的规范化了。2.0的响应内容主要也可以分为3层：最外一层是你调用服务的名称所对应的响应标记，如：获取单个商品（taobao.item.get）的响应最外层为item_get_response: ，表示这是获取单个商品的响应；中间一层是返回结构体的标记。如果结构体是单个，那么2.0返回的这一层里面就会是单个的结构，如：获取的单个商品的结构体就是
4、item: ；反之，如果结构体是多个，那么列表也会明显的表示出来，如：搜索商品列表的结构体就会是”items”:“item”: , 。最外层的items表示这是一个商品的列表，后面的item表示列表中的每一个子结构体都是属于商品item的，然后就跟着商品的数据；最内一层就商品的具体字段信息了。2. 调调用错误误返回当调用发生生错误的的时候，一一般情况况下可以以分为几几大类错错误信息息的返回回：htttp连连接错误误、平台台解析错错误、业业务处理理错误。这这三种类类型的错错误分别别代表了了：淘宝宝服务器器、淘宝宝接入平平台、ttop-apii业务，几几个层次次上出现现的问题题。1) hhttpp
5、连接错错误http连连接错误误是请求求通信过过程中出出现的错错误，这这类型错错误通常常由htttp响响应码标标记出来来。htttp响响应码由由三位十十进制数数字组成成，它们们出现在在由HTTTP服服务器发发送的响响应的第第一行。响应码分五五种类型型，由它它们的第第一位数数字表示示：1xx：信信息，请请求收到到，继续续处理2xx：成成功，行行为被成成功地接接受、理理解和采采纳3xx：重重定向，为为了完成成请求，必必须进一一步执行行的动作作4xx：客客户端错错误，请请求包含含语法错错误或者者请求无无法实现现5xx：服服务器错错误，服服务器不不能实现现一种明明显无效效的请求求Isv调用用topp服务
6、最最常收到到就是2200：htttp请求求成功；4044：未找找到请求求的服务务；5000内部部服务器器错误等等等。如如果用户户收到的的响应码码是4004，表表示用户户的网络络有问题题或者ttop被被和谐了了如如果用户户收到的的响应码码是5000，表表示网络络是okk的，是是topp的服务务无法响响应。2) 服服务端错错误总述述平台解析错错误和业业务处理理错误都都是htttp成成功访问问到toop服务务（htttp响响应码返返回为2200）之之后所产产生的错错信息，他他们toop处理理isvv请求过过程中出出现的问问题。11.0和和2.00的格式式有所不不同。1.0的错错误响应应信息最最外层为
7、为“eerroor_rrsp”: ,表示这这是调用用错误所所返回的的信息。里里面一层层包含两两个元素素：”ccodee”:” ”和 “mssg”:” ”，前者表示错误码是多少，后者表示错误信息是什么。例如错误的调用1.0的taobao.item.get服务错误时返回的错误信息：errror_rspp:coode:400,mmsg:MMisssingg reequiiredd arrgummentts:mmisssingg paarammeteer iiid/numm_iiid。这个信息的的开头为为errror_rspp，表示示这是调调用错误误所返回回的结果果。里面面包含的的错误体体的coode
8、为为40，是是平台型型错误，表表示错误误是缺少少了必传传参数所所引起的的。然后后msgg内容为为Misssinng rrequuireed aarguumennts:misssinng pparaametter iidd/nuum_iiid，表表示缺少少的必传传参数是是iidd或者nuum_iiid。Isvv解析到到这些信信息后就就需要根根据错误误信息改改进自己己传入的的参数来来使调用用成功。2.0的错错误响应应信息的的最外层层为“eerroor_rrespponsse”:” ”，表示示这是调调用服务务失败所所返回的的错误信信息。信信息体里里面一层层总共包包含了五五个元素素：aargss:ar
9、rg:“kkey”:“ ”,”vaaluee”:” ”,“kkey”:“ ”,”vaaluee”:” ”,“kkey”:“ ”,”vaaluee”:” ”，”coode”:” ”， “msg”:” ”，”sub_code”:” ”和”sub_msg”:” ”。args表示用户传入的参数列表是什么，里面是一个arg的列表会包含用户传入的所有参数信息，每个arg表示一个参数的信息，key表示参数的名称，value表示参数的内容，用以方便用户定位自己的错误；code表示用户调用错误的错误码是多少，小于200表示平台级错误，200-1000之间表示大范围的业务错误，即哪一类型的api调用发生了错误（根
10、据api的大类来分，如：商品类的api是530，交易类的api是520，等）；msg表示大类型的错误码所对应的错误信息，一般不具备独立的debug作用，需要和sub_code和sub_msg一起使用才行；sub_code是调用错误的子错误码，他表示用户调用错误的原因；sub_msg是子错误码所对应的错误信息，他用来补充细化子错误码的错误原因的。例如调用2.0的taobao.item.get服务错误时返回的错误信息：errror_ressponnse:arggs:aarg:keey:appp_kkey,vvaluue:1557399,kkey:ffiellds,vvaluue:liist_tim
11、me,ddeliist_timme,aapprrovee_sttatuus,keyy:forrmatt,vallue:jjsonn,kkey:mmethhod,vvaluue:taaobaao.iitemm.geet,keyy:nicck,vaaluee:tbttestt5611,kkey:pparttnerr_idd,vallue:TTOPTTESTT,kkey:ssignn,vallue:6668FFB4AA0499F711A1CC8455EF88C055B1FF3E666,keyy:timmesttampp,vallue:220100-033-055 188:033:066.3225,k
12、eyy:v,vaaluee:2.00,codde:5300,mmsg:RRemoote serrvicce eerroor,suub_ccodee:misssinng-pparaametter,ssub_msgg:iidd和num_iidd至少要要传入一一个这个信息的的开头为为errror_ressponnse，表表示这是是调用错错误所返返回的错错误信息息。里面面的arrgs列列出了用用调用这这个接口口传入的的信息有有：keey:appp_kkey,vvaluue:1557399,kkey:ffiellds,vvaluue:liist_timme,ddeliist_timme,aapprrov
13、ee_sttatuus,keyy:forrmatt,vallue:jjsonn,kkey:mmethhod,vvaluue:taaobaao.iitemm.geet,keyy:nicck,vaaluee:tbttestt5611,kkey:pparttnerr_idd,vallue:TTOPTTESTT,kkey:ssignn,vallue:6668FFB4AA0499F711A1CC8455EF88C055B1FF3E666,keyy:timmesttampp,vallue:220100-033-055 188:033:066.3225,keyy:v,vaaluee:2.00，这些些信息是是
14、从用户户的请求求信息里里面解析析出来的的。错误误码coode为为5300，表示示这是调调用商品品的appi所产产生的错错误。错错误信息息msgg为Remmotee seerviice errror表表示这是是调用业业务处理理所产生生的错误误。子错错误码ssub_codde为：misssinng-pparaametter，表表示这个个错误是是因为缺缺少了参参数所产产生的。子子错误信信息suub_mmsg为为：iiid和numm_iiid至少少要传入入一个，表表示少传传的参数数为iiid或numm_iiid。这这所有的的错误信信息叠加加起来可可以知道道，这个个错误是是用户调调用taaobaao.iitemm.geet接口口时业务务处理发发现用户户没有传传入商品品id所导导致的。3) 平平台解析析错误平台解析错错误是指指topp返回的的错误码码小于1100的的情况。平平台解析析是非业业务性的的普适的的校验接接入层，主主要用于于对用户户的各种种权限、和和入参进进行最基基本的校校验。现现在的平平台错误误码主要要有：Isv可以以通过错错误码和和解释来来纠正问问题。如如：错误误码为33的响应应表示图图片上传传失败，错错误码为为26表示示用户没没有传入入ses
