ESP32 WiFi reason 202: AUTH_FAIL
The access point answered the ESP32's authentication request and refused it. Unlike a timeout, something on the access point side said no.
WIFI_REASON_AUTH_FAIL (202). Espressif's description: Authentication failed.
Espressif's description only says that authentication failed for a reason other than a timeout. In practice it comes from the access point's side:
Common cases
- MAC address filtering on the router, with the ESP32's MAC not on the list.
- The security mode: WPA3-only (SAE) networks and stations configured differently; check the router's security setting and the station's
threshold.authmode. - The access point is full or rate-limits new clients after many quick reconnects. Reconnect with a growing delay, not in a tight loop.
- A wrong password on some access points, which refuse at this step instead of letting the handshake time out.
Where you see the number
In ESP-IDF, the WIFI_EVENT_STA_DISCONNECTED event carries it: ((wifi_event_sta_disconnected_t *) event_data)->reason. In Arduino, the ARDUINO_EVENT_WIFI_STA_DISCONNECTED event has it in info.wifi_sta_disconnected.reason, and WiFi.disconnectReasonName() turns it into a name. Log it every time: the reason is what separates a wrong password from a weak signal.
When it happens at a customer's site
On your desk you see the reason in the log. On a device behind someone else's router you only hear that it "goes offline sometimes". Pinscope keeps the device's logs and its WiFi signal over time, so you can see which reason it disconnected with and whether the signal was dropping before it did. Free for three devices. Remote logging.
Related errors: WiFi reason 15 / 204: handshake timeout · WiFi reason 210: NO_AP_FOUND_W_COMPATIBLE_SECURITY · WiFi reason 201: NO_AP_FOUND · WiFi disconnect reasons. All ESP32 errors: the list. Reason codes and their meaning from Espressif's Wi-Fi Driver guide and esp_wifi_types.h.
More
- Remote access to an ESP32 without TLS: what it measured and what it costs
- Reaching an ESP32 web server from outside its network
- Updating ESP32 firmware over the internet, with rollback
- Guru Meditation Error: decoding the backtrace, and crashes from the field
- Remote logging: ESP_LOG without a serial cable
- Heap and stack monitoring in the field
- An ESP32 behind CGNAT, 4G or Starlink
- TLS memory usage on the ESP32, and how to reduce it
- Sharing an ESP32 sensor page with anyone, without port forwarding
- ArduinoOTA over the internet, with a rollback
- ESP32 remote access compared: port forwarding, ngrok, Cloudflare Tunnel, Tailscale
- esp_http_server slow? The 250 ms delay and the fix
- Before the first ESP32 ships: a field support checklist
- ESP32 exception decoder: a Guru Meditation backtrace to lines, in the browser