Dokumentasi pembangun platform awam WeChat / 微信连网过程常见错误码

微信连网过程常见错误码

连网过程常见错误码


常见错误码错误码解析解决方法
31305032微信portal鉴权连网流程中,当微信客户端向认证服务端URL发起请求时,返回的HTTP     Status Code既不是200也不是302。请手机抓包确定HTTP   Status     Code,并检查认证服务是否正常。微信客户端判断逻辑:若http返回码为200,则认为服务认证成功;若认证服务器需要转移认证请求,请返回302和下一跳地址,微信客户端将向下一跳地址再发起一次请求,302跳转仅支持一次;对于非200和302,或者超过次数的302返回码,视为认证失败,此次连网失败,微信客户端跳转到连接失败页。
31305033微信portal鉴权连网流程中,当微信客户端向认证服务端URL发起请求时,302转跳次数超过限制。请返回302和下一跳地址,微信客户端将向下一跳地址再发起一次请求,302跳转仅支持一次。
31305101微信portal鉴权连网流程中,当微信客户端向认证服务端URL发起请求时,出现Connect     Timeout、Read Timeout、Connect Reset、SSL handshake failed等HTTP网络异常。为了确保用户体验,微信客户端设置HTTP读写超时时间都设置为5000ms,请确保认证服务端URL在5000ms内响应。如果是SSL     handshake     failed错误,请排查认证服务端log,并用最新的微信客户端调试成功后再上线,可能有以下原因:客户端配置了必须对服务器端进行身份验证,但SSL服务器端证书不存在,或者证书不能被信任;服务器端配置了必须对客户端进行身份验证,但SSL客户端的证书不存在或不能被信任;SSL服务器端和客户端没有匹配的加密套件。
31305102微信portal鉴权连网流程中,当微信客户端向认证服务端URL发起请求时,出现unknown     host错误,即无法解析认证服务端URL的域名。(1)如果设备上未抓到DNS请求记录,那么请排查手机当前是否使用移动数据网络,而认证服务端URL的域名是本地的(IOS如果网络不通Wi-Fi会被切到移动数据网络,务必完全临时放行)。
    (2)如果设备上抓到DNS请求记录,那么请确认本地DNS服务器工作配置正确,并正确响应了手机的请求。
31305104微信portal鉴权连网流程中,当微信客户端向认证服务端URL发起请求时,超过5000ms未成功连接,出现Connect     Timeout错误。(新版本微信客户端对HTTP网络异常细分出的错误码)微信客户端设置HTTP读写超时时间都设置为5000ms,请确保认证服务端URL在5000ms内响应。
31305105微信portal鉴权连网流程中,当微信客户端向认证服务端URL发起请求时,超过5000ms未数据回包,出现Read     Timeout错误。(新版本微信客户端对HTTP网络异常细分出的错误码)微信客户端设置HTTP读写超时时间都设置为5000ms,请确保认证服务端URL在5000ms内响应。
31305106微信portal鉴权连网流程中,当微信客户端向认证服务端URL发起请求时,出现目标主机无法路由或不可达错误。(新版本微信客户端对HTTP网络异常细分出的错误码)请确保本地网络配置正确,并用最新的微信客户端调试成功后再上线。
31305111微信portal鉴权连网流程中,当IOS版微信客户端向认证服务端URL发起请求时,出现unknown     host错误或者HTTP网络异常。出现该错误码最常见的原因是针对IOS终端临时放行出现问题,IOS系统如果发现网络不通Wi-Fi会被切到移动数据网络,导致连网失败。请务必做到当用户在Portal发起连网后,完全临时放行或者白名单放行www.appleiphonecell.com、captive.apple.com、www.itools.info、www.ibook.info、www.aiport.us、www.thinkdifferent.us、www.apple.com等IOS探测通网域名。另外,请确保本地网络配置正确和认证服务正常。
31033XXX微信portal鉴权连网流程中,当请求认证服务端URL通过后,微信客户端向微信Server请求成功连接页信息时,发生连接错误。错误码格式为31033XXX,其中XXX三位为http状态码,如50X、40X、30X系列状态码。请确保认证服务器放行成功后,设备同步放行了当前连接用户。
32306036微信Portal设备扫二维码连Wi-Fi流程中,微信客户端发出嗅探请求访问任意黑名单URL时,嗅探302次数超过限制。微信Portal设备扫二维码连Wi-Fi流程利用302响应中的location信息传递authUrl和extend参数,如果第一次302没有携带则继续访问302返回的location,直到拿到authUrl和extend,最多302转跳3次。
32306035微信Portal设备扫二维码连Wi-Fi流程中,微信客户端发出嗅探请求访问任意黑名单URL时,嗅探请求返回后不能发现authUrl和extend参数,可能并未返回302执行下一跳,区别于302次数超过限制。确保对嗅探请求返回302并且302响应中的location信息传递authUrl和extend参数。
32306032微信Portal设备扫二维码连Wi-Fi流程中,当微信客户端向认证服务端URL发起请求时,返回的HTTP     Status Code既不是200也不是302。参考31305032的解决方法。
32306033微信Portal设备扫二维码连Wi-Fi流程中,当微信客户端向认证服务端URL发起请求时,302转跳次数超过限制。参考31305033的解决方法。
32306101微信Portal设备扫二维码连Wi-Fi流程中,当微信客户端向黑名单URL或者认证服务端URL发起请求时,出现Connect     Timeout、Read Timeout、Connect Reset、SSL handshake failed等HTTP网络异常。参考31305101的解决方法。
32306102微信Portal设备扫二维码连Wi-Fi流程中,当微信客户端向黑名单URL或者认证服务端URL发起请求时,出现unknown     host错误,即无法解析认证服务端URL的域名。参考31305102的解决方法。
32306104微信Portal设备扫二维码连Wi-Fi流程中,当微信客户端向黑名单URL或者认证服务端URL发起请求时,超过5000ms未成功连接,出现Connect     Timeout错误。(新版本微信客户端对HTTP网络异常细分出的错误码)参考31305104的解决方法。
32306105微信Portal设备扫二维码连Wi-Fi流程中,当微信客户端向黑名单URL或者认证服务端URL发起请求时,超过5000ms未数据回包,出现Read     Timeout错误。(新版本微信客户端对HTTP网络异常细分出的错误码)参考31305105的解决方法。
32306106微信Portal设备扫二维码连Wi-Fi流程中,当微信客户端向黑名单URL或者认证服务端URL发起请求时,出现目标主机无法路由或不可达错误。(新版本微信客户端对HTTP网络异常细分出的错误码)参考31305106的解决方法。
32020014微信Portal设备扫二维码连Wi-Fi流程中,当微信安卓客户端连接目标ssid时,启动认证流程失败,直接被AP拒绝。请确保使用Portal型设备和本地网络配置正确,并用最新的微信客户端调试成功后再上线。
32020016微信Portal设备扫二维码连Wi-Fi流程中,当微信安卓客户端连接目标ssid时,超过5000ms未成功连上ssid,报超时错误。请确保本地网络配置正确,并用最新的微信客户端调试成功后再上线。
32033XXX微信Portal设备扫二维码连Wi-Fi流程中,当请求认证服务端URL通过后,微信客户端向微信Server请求成功连接页信息时,发生连接错误。错误码格式为32033XXX,其中XXX三位为http状态码,如50X、40X、30X系列状态码。请确保认证服务器放行成功后,设备同步放行了当前连接用户。
04020014微信密码设备连Wi-Fi流程中,当微信安卓客户端连接目标ssid时,超过5000ms未成功连上ssid,报超时错误。请确保本地网络配置正确,并用最新的微信客户端调试成功后再上线。
04020016微信密码设备连Wi-Fi流程中,当微信安卓客户端连接目标ssid时,启动认证流程失败,直接被AP拒绝。请确保本地网络配置正确,并用最新的微信客户端调试成功后再上线。
04020018微信密码设备连Wi-Fi流程中,当微信安卓客户端连接目标ssid时,认证流程中失败,一般是密码错误。请确保在微信连Wi-Fi平台注册设备时填的密码正确。
04033XXX微信密码设备连Wi-Fi流程中,当微信安卓客户端成功连接目标ssid后,微信客户端向微信Server请求成功连接页信息时,发生连接错误。错误码格式04033XXX,其中XXX三位为http状态码,如50X、40X、30X系列状态码。请确保在密码校验通过后,设备成功放行。