HTTP Reference
HTTP 502 Bad Gateway
An upstream server returned an invalid response to a gateway/proxy.
Common Causes
- Reverse proxy received malformed upstream response.
- Upstream service crashed mid-request.
- Network errors between edge and origin service.
Debugging Notes
- Inspect gateway logs and upstream health metrics together.
- Validate timeout and retry behavior between services.
Example Response
{
"status": 502,
"error": "Bad Gateway",
"message": "Upstream service failure"
}