微信平台开发 报警排查指引

由 如此轻盈 创建，Carrie 最后一次修改 2016-09-23 概要说明微信公众平台已对外开放接口报警，当微信服务器向开发者推送消息失败次数达到预定阈值时，会将报警消息发送到指定微信报警群中（设置方式：公众平台->开发-运维中心->接口报警），请开发者积极主动关注报警，即时解决故障，提高微信公众号的服务质量。为了更好地根据报警信息尾部的实例（提供了openid及时间戳stamp）进行问题排查，开发者需要在接入层、逻辑层等每一个层级都加上包含关键信息的详细日志，以利于快速定位问题。报警目前有2类：1.通用报警，所有开发者都需要关注。类型描述DNS失败微信服务器向公众号推送消息或事件时，解析DNS失败DNS超时微信服务器向公众号推送消息或事件时，解析DNS超时，超时时间为5秒连接超时微信服务器连接公众号开发者服务器时发生超时，超时时间为5秒请求超时微信服务器向公众号推送消息或事件后，开发者5秒内没有返回回应失败微信服务器向公众号推送消息或事件后，得到的回应不合法MarkFail（自动屏蔽）微信服务器向公众号推送消息或事件发生多次失败后，暂时不推送消息，一分钟后解除屏蔽2.公众号第三方平台报警，只有在微信开放平台（open.weixin.qq.com）上申请成为公众号第三方平台的开发者，才需要关注此报警。类型描述推送component_verify_ticket超时推送component_verify_ticket时，开发者5S内没有返回推送component_verify_ticket失败推送component_verify_ticket时，开发者没有返回success推送第三方平台消息超时推送第三方平台消息（如取消授权消息）等，第三方平台5秒内没有返回推送第三方平台消息失败推送第三方平台消息（如取消授权消息）等，第三方平台没有返回success下面对具体的报警做示例以及排查指引说明。报警内容说明报警内容描述：a)appid：公众号appidb)昵称: 公众号昵称c)时间：所有报警，都会提供首次发生异常的时间。（如首次发生超时的时间，首次发生回应失败的时间）d)内容：错误的具体描述e)次数：发生失败的次数f)错误样例：错误样例里注明了一些帮助查找问题的信息。如：首次超时开发者的IP和推送消息类型。如果是回应失败，错误样例还会注明首次回应失败时开发者的回包。一般情况下，通过报警提供的IP，时间，消息类型，能够比较快速的定位到第三方发生问题的原因。报警示例1：超时报警Appid: wxxxxxx昵称: WxNickName时间: 2014-12-01 20:12:00内容: 微信服务器向公众号推送消息或事件后，开发者5秒内没有返回次数: 5分钟 1272次错误样例: [IP=203.205.140.29][Event=UnSubscribe]该报警表示：微信服务器向开发者推送取消关注事件时，开发者没有在5秒内返回结果。在2014-12-01 20:12:00-2014-12-01 20:17:00这5分钟内发生了1272次。其中这5分钟内第一次发生超时的时间是：2014-12-01 20:12:00， 开发者的IP是：203.205.140.29，事件类型是取消关注事件。报警示例2：回应失败Appid: wxxxx昵称: WxNickName时间: 2014-12-01 20:12:00内容: 微信服务器向公众号推送消息或事件后，得到的回应不合法次数: 5分钟 1320次错误样例: [Event=Click] [ip=58.248.9.218][response_length=10][response_content=Error 500:]该报警表示：微信服务器向开发者推送自定义菜单点击事件时，开发者的返回结果不合法。在2014-12-01 20:12:00-2014-12-01 20:17:00这5分钟内发生了1320次。其中这5分钟内第一次发生回应失败的时间是：2014-12-01 20:12:00， 开发者的IP是：58.248.9.218，事件类型是点击菜单事件，第三方返回的内容长度为10个字节，内容为“Error 500:”。报警示例3：连接超时Appid: wxxxx昵称: WxNickName时间: 2015-02-04 20:13:09内容: 微信服务器连接公众号开发者服务器时发生超时，超时时间为5秒次数: 5分钟 7289次错误样例: [IP=180.150.190.135][Msg=Text]该报警表示：微信服务器向开发者推送粉丝发来的文本消息时，无法连接到开发者填写的服务器地址。在2015-02-04 20:13:09-2015-02-04 20:18:00这5分钟内发生了7289次，这5分钟内第一次发生连接超时的时间是：2015-02-04 20:13:09， 开发者的IP是：180.150.190.135，事件类型是用户推送的消息。各类报警的排查方法1.DNS失败该错误为微信服务器在推送消息给开发者时，解析dns失败。如遇到此报警，请开发者确认：a）填写的url,域名是否有误；b) 域名是否发生变化，如过期，更新等。如果不是以上2个问题，请联系微信公众平台。2.Dns超时目前不会有此错误。3.连接超时该错误是微信服务器和开发者服务器3S内未连接成功。报警消息会提供出首次发生连接失败的时间和连接的IP。如遇此报警，请开发者确认：a)该IP是否有误。b)该IP机器是否过载，连接过多。c)如果是第三方提供服务器托管，托管商是否有故障。d)网络运营商是否有故障。4.请求超时微信服务器向开发者服务器推送消息或事件，开发者5秒内没有返回。请求超时时，报警消息会提供第一次出现请求超时的时间，开发者IP和消息类型。请开发者确认：a）该IP是否有误b）该IP是否接收到报警消息给出的该消息类型的请求c）该请求是否处理时间过长5.回应失败开发者没有按照wiki中的回复消息格式进行回复消息，或者发生网络错误，会报警回应失败，报警消息会提供第一次出现请求回应失败的时间，开发者的IP，消息类型以及回应的消息内容，请开发者确认：a）该IP是否有误b）该IP是否发生网络错误c）该业务处理逻辑是否没有按照wiki规范回复消息，或是进入了异常逻辑。6.MarkFail（自动屏蔽）微信后台会实时统计开发者的失败次数。在推送消息给开发者发生大量失败时，微信服务器会自动屏蔽开发者，1分钟内不再推送任何消息，并会发送报警到微信群。此报警是级别最高的报警，开发者在收到此报警时请尽快处理后台故障，恢复服务。事实上，开发者在收到此报警前，必然会收到连接超时，请求超时或回应失败等报警，需要开发者即时去解决这些故障，避免被微信服务器屏蔽，严重影响公众号服务！7.推送component_verify_ticket超时 & 8.推送component_verify_ticket失败 & 9.推送组件消息超时 & 10.推送组件消息失败以上4个报警只有公众号第三方平台开发者会收到，其他公众号开发者无需关注。由于公众号第三方平台承载了更多的公众号，所以公众号第三方平台的服务质量需要更