微信连网过程常见错误码 - 微信公众号开发手册

连网过程常见错误码

微信连网过程常见错误码

常见错误码	错误码解析	解决方法
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会被切到移动数据网络，务必完全临时放行）。
31305102		(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系列状态码。	请确保在密码校验通过后，设备成功放行。