WeChat public platform developer documentation
/ 微信连网过程常见错误码
微信连网过程常见错误码
连网过程常见错误码
| 常见错误码 | 错误码解析 | 解决方法 |
| 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系列状态码。 | 请确保在密码校验通过后，设备成功放行。 |