HTTP Warning Header

Der HTTP-Header Warning ist ein Response-Header, der zusätzliche Informationen über mögliche Probleme mit der Response kommuniziert. Er stammt aus HTTP/1.1 und gilt als deprecated, wird aber noch von Legacy-Systemen verwendet.

Typ

Response-Header

Syntax

Der Header definiert Warning-Code, Agent und optionale Beschreibung.

http 
Warning: 110 cache.example.com "Response is Stale"
Warning: 214 proxy.internal "Transformation Applied"

Direktiven

Die Direktiven definieren Art und Quelle der Warnung.

<warn-code>
Dreistelliger Warning-Code (110-299), definiert die Art der Warnung.
<warn-agent>
Hostname oder Pseudonym des Servers/Proxies, der die Warnung generiert hat.
<warn-text>
Optionale lesbare Beschreibung in Anführungszeichen.
<warn-date>
Optional: Zeitstempel wann die Warnung generiert wurde.

Beispiele

Nachfolgend finden Sie praktische Anwendungsbeispiele für den Warning-Header.

Beispiel 1 Stale Cache Response

http 
HTTP/1.1 200 OK
Cache-Control: max-age=3600
Age: 7200
Warning: 110 cache-proxy.example.com "Response is Stale"
Content-Type: application/json

{"data": "cached content"}

Proxy liefert veraltete gecachte Response, weil Origin-Server nicht erreichbar ist, Warning informiert Client.

Beispiel 2 Heuristic Expiration

http 
HTTP/1.1 200 OK
Warning: 113 cdn.example.com "Heuristic Expiration"
Last-Modified: Mon, 01 Jan 2024 10:00:00 GMT

[content without explicit cache directives]

CDN verwendet heuristische Cache-Berechnung basierend auf Last-Modified, da keine expliziten Cache-Direktiven vorhanden sind.

Beispiel 3 Transformation Applied

http 
HTTP/1.1 200 OK
Warning: 214 compression-proxy "Transformation Applied"
Content-Type: image/jpeg
Content-Encoding: gzip

[transformed/compressed image]

Proxy hat Response transformiert durch zusätzliche Kompression oder Bildoptimierung.

Standard Warning Codes

Die wichtigsten Warning-Codes sind:

110 Response is Stale
Cache liefert veraltete Response.
111 Revalidation Failed
Cache konnte Revalidierung nicht durchführen.
112 Disconnected Operation
Cache arbeitet absichtlich offline.
113 Heuristic Expiration
Cache verwendet heuristische Freshness-Berechnung.
199 Miscellaneous Warning
Beliebige Warnung mit Beschreibung.
214 Transformation Applied
Proxy hat Payload transformiert.
299 Miscellaneous Persistent Warning
Persistente Warnung für nachfolgende Responses.

Warning Header Flow

Warning Header Cache Flow

Vorteile für die Systemarchitektur

  • Transparenz bei Cache-Problemen: Client erfährt, wenn Response nicht fresh ist trotz 200 OK Status
  • Debugging-Informationen: Proxy-Transformationen und Heuristiken werden sichtbar
  • Graceful Degradation: Stale-Responses mit Warning erlauben Verfügbarkeit trotz Origin-Ausfall

Spezifikation

RFC 9111, Section 5.5 – HTTP Caching (Warning deprecated) https://www.rfc-editor.org/rfc/rfc9111.html#name-warning RFC 7234 – HTTP/1.1 Caching (original specification) https://www.rfc-editor.org/rfc/rfc7234.html#section-5.5

Weitere Spezifikationen

Cache-Control Header, HTTP Status 200 - OK