topic
Verified 2026-09-18

HTTP/2 Error Codes

HTTP/2 error codes identify connection and stream failures in a binary protocol that can continue serving independent streams.

Map protocol errors to the correct connection or stream scope, close only what is necessary, and avoid exposing raw peer diagnostics as application errors. A gateway should translate errors deliberately when crossing HTTP versions.

httpprotocolhttp2errors

Reference (http)

RST_STREAM: CANCEL
GOAWAY: ENHANCE_YOUR_CALM

Map protocol errors to the correct connection or stream scope, close only what is necessary, and avoid exposing raw peer diagnostics as application errors. A gateway should translate errors deliberately when crossing HTTP versions.

Common mistakes

  • Closing the entire connection for a stream-local error, retrying a non-idempotent request after a connection error, or treating ENHANCE_YOUR_CALM as an application status.
Permalink: https://merginit.com/reference/http/http2-error-codes