| Common error codes | Error code analysis | Solution |
| 31305032 | During the WeChat portal authentication and networking process, when the WeChat client initiates a request to the authentication server URL, the returned HTTP Status Code is neither 200 nor 302. | Please capture the packet on your mobile phone to confirm the HTTP Status Code, and check whether the authentication service is normal. WeChat client judgment logic: If the http return code is 200, the service authentication is considered successful; if the authentication server needs to transfer the authentication request, please return 302 and the next hop address, and the WeChat client will initiate another request to the next hop address. The 302 jump is only supported once; for non-200 and 302, or 302 return codes that exceed the number of times, it is regarded as an authentication failure. If the connection fails this time, the WeChat client will jump to the connection failure page. |
| 31305033 | During the WeChat portal authentication and networking process, when the WeChat client initiates a request to the authentication server URL, the number of 302 redirects exceeds the limit. | Please return 302 and the next hop address. The WeChat client will initiate another request to the next hop address. The 302 jump is only supported once. |
| 31305101 | During the WeChat portal authentication and networking process, when the WeChat client initiates a request to the authentication server URL, Connect Timeout, Read Timeout, and Connect Reset appear. , SSL handshake failed and other HTTP network abnormalities. | In order to ensure user experience, the WeChat client sets the HTTP read and write timeout to 5000ms. Please ensure that the authentication server URL responds within 5000ms. If it is an SSL handshake failed error, please check the authentication server log, and use the latest WeChat client to successfully debug before going online. The possible reasons are as follows: the client is configured to authenticate the server, but the SSL server certificate does not exist. , or the certificate cannot be trusted; the server is configured to authenticate the client, but the SSL client's certificate does not exist or cannot be trusted; the SSL server and client do not have matching cipher suites. |
| 31305102 | During the WeChat portal authentication and networking process, when the WeChat client initiates a request to the authentication server URL, an unknown host error occurs, that is, the authentication cannot be parsed. The domain name of the server URL. | (1) If no DNS request record is captured on the device, please check whether the phone is currently using a mobile data network, and the domain name of the authentication server URL is local (IOS will be blocked if the network is not connected to Wi-Fi. Switch to mobile data network and must be completely temporarily released). |
| (2) If a DNS request record is captured on the device, please confirm that the local DNS server is configured correctly and responds correctly to the mobile phone's request. |
| 31305104 | During the WeChat portal authentication and networking process, when the WeChat client initiates a request to the authentication server URL, the connection fails for more than 5000ms and a Connect Timeout appears. mistake. (Error code broken down by the new version of WeChat client for HTTP network anomalies) | WeChat client sets HTTP read and write timeouts to 5000ms. Please ensure that the authentication server URL responds within 5000ms. |
| 31305105 | During the WeChat portal authentication and networking process, when the WeChat client initiates a request to the authentication server URL, no data is returned for more than 5000ms, and Read appears. Timeout error. (Error codes broken down by the new version of WeChat client for HTTP network anomalies) | WeChat client sets HTTP read and write timeouts to 5000ms. Please ensure that the authentication server URL responds within 5000ms. |
| 31305106 | During the WeChat portal authentication and networking process, when the WeChat client initiates a request to the authentication server URL, an error that the target host cannot be routed or unreachable occurs. . (Error code broken down by the new version of WeChat client for HTTP network anomalies) | Please ensure that the local network configuration is correct, and use the latest WeChat client to successfully debug before going online. |
| 31305111 | During the WeChat portal authentication and networking process, when the IOS version of WeChat client initiates a request to the authentication server URL, an unknown host error or HTTP network occurs. abnormal. | The most common reason for this error code is that there is a problem with the temporary release of the IOS terminal. If the IOS system finds that the Wi-Fi network is unavailable, it will be switched to the mobile data network, causing the network connection to fail. Please make sure that when the user initiates a network connection in the Portal, complete temporary release or whitelist release of www.appleiphonecell.com, captive.apple.com, www.itools.info, www.ibook.info, www.aiport.us, www.thinkdifferent.us, www.apple.com and other IOS detection domain names on the Internet. In addition, please ensure that the local network configuration is correct and the authentication service is normal. |
| 31033XXX | In the WeChat portal authentication and networking process, when the requested authentication server URL passes, the WeChat client requests the successful connection page information from the WeChat Server. A connection error occurred. The error code format is 31033XXX, where the three digits of XXX are http status codes, such as 50X, 40X, and 30X series status codes. | Please ensure that after the authentication server releases successfully, the device simultaneously releases the currently connected user. |
| 32306036 | During the process of scanning the QR code on the WeChat Portal device to connect to Wi-Fi, when the WeChat client sends a sniffing request to access any blacklisted URL, sniffing 302 The number of times exceeds the limit. | The WeChat Portal device scans the QR code to connect to Wi-Fi. The process uses the location information in the 302 response to pass the authUrl and extend parameters. If the first 302 does not carry it, continue to access the location returned by 302 until the authUrl is obtained. and extend, up to 302 jumps. |
| 32306035 | During the process of scanning the QR code on the WeChat Portal device to connect to Wi-Fi, when the WeChat client sends a sniffing request to access any blacklisted URL, the sniffing request The authUrl and extend parameters cannot be found after returning, and 302 may not be returned to execute the next hop, which is different from the 302 number of times exceeding the limit. | Ensure that 302 is returned for sniffing requests and that the location information in the 302 response passes the authUrl and extend parameters. |
| 32306032 | During the process of scanning the QR code on the WeChat Portal device to connect to Wi-Fi, when the WeChat client initiates a request to the authentication server URL, the returned HTTP Status Code is neither 200 nor 302. | Refer to the solution of 31305032. |
| 32306033 | During the process of connecting to Wi-Fi by scanning the QR code on the WeChat Portal device, when the WeChat client initiates a request to the authentication server URL, the number of 302 redirects exceed the limit. | Refer to the solution of 31305033. |
| 32306101 | When the WeChat Portal device scans the QR code to connect to Wi-Fi, when the WeChat client initiates a request to the blacklist URL or authentication server URL, HTTP network exceptions such as Connect Timeout, Read Timeout, Connect Reset, SSL handshake failed, etc. occur. | Refer to the solution of 31305101. |
| 32306102 | When the WeChat Portal device scans the QR code to connect to Wi-Fi, when the WeChat client initiates a request to the blacklist URL or the authentication server URL, An unknown host error occurs, that is, the domain name of the authentication server URL cannot be resolved. | Refer to the solution of 31305102. |
| 32306104 | When the WeChat Portal device scans the QR code to connect to Wi-Fi, when the WeChat client initiates a request to the blacklist URL or the authentication server URL, If the connection is not successful for more than 5000ms, a Connect Timeout error occurs. (Error code broken down by the new version of WeChat client for HTTP network anomalies) | Refer to the solution of 31305104. |
| 32306105 | When the WeChat Portal device scans the QR code to connect to Wi-Fi, when the WeChat client initiates a request to the blacklist URL or authentication server URL, If no data is returned for more than 5000ms, a Read Timeout error occurs. (Error code broken down by the new version of WeChat client for HTTP network anomalies) | Refer to the solution of 31305105. |
| 32306106 | When the WeChat Portal device scans the QR code to connect to Wi-Fi, when the WeChat client initiates a request to the blacklist URL or the authentication server URL, A destination host unroutable or unreachable error occurred. (Error code broken down by the new version of WeChat client for HTTP network anomalies) | Refer to the solution of 31305106. |
| 32020014 | When the WeChat Portal device scans the QR code to connect to Wi-Fi, when the WeChat Android client connects to the target SSID, the authentication process fails to start and is directly blocked. AP refused. | Please ensure that the Portal type device and local network configuration are used correctly, and use the latest WeChat client to successfully debug before going online. |
| 32020016 | During the process of scanning the QR code on the WeChat Portal device to connect to Wi-Fi, when the WeChat Android client connects to the target SSID, it takes more than 5000ms to fail to successfully connect to the SSID. , a timeout error is reported. | Please ensure that the local network configuration is correct, and use the latest WeChat client to successfully debug before going online. |
| 32033XXX | During the process of scanning the QR code on the WeChat Portal device to connect to Wi-Fi, when the request for the authentication server URL passes, the WeChat client's request to the WeChat Server is successful. A connection error occurred while connecting to the page information. The error code format is 32033XXX, where the three digits of XXX are http status codes, such as 50X, 40X, and 30X series status codes. | Please ensure that after the authentication server releases successfully, the device simultaneously releases the currently connected user. |
| 04020014 | During the process of connecting the WeChat password device to Wi-Fi, when the WeChat Android client connects to the target SSID, it takes more than 5000ms to fail to successfully connect to the SSID and a timeout error is reported. . | Please ensure that the local network configuration is correct, and use the latest WeChat client to successfully debug before going online. |
| 04020016 | In the process of connecting the WeChat password device to Wi-Fi, when the WeChat Android client connects to the target SSID, the authentication process fails to start and is directly rejected by the AP. | Please ensure that the local network configuration is correct, and use the latest WeChat client to successfully debug before going online. |
| 04020018 | In the process of connecting the WeChat password device to Wi-Fi, when the WeChat Android client connects to the target SSID, the authentication process fails, usually because the password is wrong. | Please ensure that the password you filled in when registering the device on the WeChat Wi-Fi platform is correct. |
| 04033XXX | In the process of connecting the WeChat password device to Wi-Fi, when the WeChat Android client successfully connects to the target SSID, the WeChat client requests the WeChat Server for a successful connection page message, a connection error occurred. The error code format is 04033XXX, where the three digits of XXX are http status codes, such as 50X, 40X, and 30X series status codes. | Please ensure that the device is successfully released after the password verification is passed.
|
