nginx/nginx

Improve handling of Age header with $upstream_cache_age

Open

#1.234 geöffnet am 31. März 2026

Auf GitHub ansehen
 (1 Kommentar) (0 Reaktionen) (1 zugewiesene Person)C (7.903 Forks)batch import
enhancementfeaturegood first issuerefined

Repository-Metriken

Stars
 (30.331 Stars)
PR-Merge-Metriken
 (Durchschn. Merge 27T 8h) (17 gemergte PRs in 30 T)

Beschreibung

Feature Overview

A new variable $upstream_cache_age was introduced to reflect response age, including:

  • Time spent in cache
  • Upstream response age from the Age header
  • If not cached, it reflects the upstream Age header directly

This enables use cases aligned with the HTTP/1.1 caching model, for example:

add_header Age $upstream_cache_age;

Problem:

Current behavior has unintended side effects:

  1. Age header is removed when using: add_header Age $upstream_cache_age
  2. expires directive removes the existing Age header Assumes zero age when setting Expires and Cache-Control

This leads to:

  • Loss of upstream-provided Age information
  • Incorrect cache semantics from a client perspective
  • Deviation from standard HTTP caching behavior

Expected Behavior

  • Preserve upstream Age header unless explicitly overridden
  • Allow $upstream_cache_age to:
    • Override OR
    • Extend existing Age header (configurable behavior)

References Changeset: https://freenginx.org/hg/nginx/rev/e46e1ea89ccd Additional: https://freenginx.org/hg/nginx/rev/8cdab3d89c44

Contributor Guide

Research-Richtung
Implementieren Sie die korrekte Handhabung des Age Headers in nginx: Bewahren Sie das upstream Age, sofern nicht überschrieben, und erlauben Sie $upstream cache age, es zu erweitern oder zu überschreiben. Ändern Sie die relevanten Module (z. B. ngx http upstream, ngx http header filter), um die Age Header Semantik korrekt zu behandeln. Stellen Sie die Konformität mit RFC 7234 sicher.
Tech Stack
c
Domain
backend
Issue Type
Funktion
SchwierigkeitGeschätzte Implementierungsschwierigkeit für neue Contributors, von 1 für sehr kleine Änderungen bis 5 für Expertenarbeit.
4
Geschätzte ZeitEin grober Zeitrahmen, um zu recherchieren, zu implementieren, zu testen und einen Pull Request vorzubereiten.
1-2 Tage
AktivitätsstatusWie verfügbar das Issue gerade wirkt: frisch, aktiv, stale, blockiert oder wartet auf Maintainer-Input.
Aktiv
KlarheitWie klar das Issue die erwartete Änderung, Akzeptanzkriterien und den nächsten Schritt erklärt.
Meist klar
Voraussetzungen
CHTTP cachingnginx internals
EinsteigerfreundlichkeitEin Score von 1 bis 100, der schätzt, wie zugänglich dieses Issue für First-Time Contributors ist.
40