nginx/nginx

Improve handling of Age header with $upstream_cache_age

Open

#1.234 aberto em 31 de mar. de 2026

Ver no GitHub
 (1 comment) (0 reactions) (1 assignee)C (7.903 forks)batch import
enhancementfeaturegood first issuerefined

Métricas do repositório

Stars
 (30.331 stars)
Métricas de merge de PR
 (Mesclagem média 27d 8h) (17 fundiu PRs em 30d)

Description

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

Guia do colaborador

Direção de pesquisa
Implementar o tratamento correto do cabeçalho Age no nginx: preservar o Age upstream a menos que seja substituído, e permitir que $upstream cache age estenda ou substitua. Modificar os módulos relevantes (por exemplo, ngx http upstream, ngx http header filter) para lidar corretamente com a semântica do cabeçalho Age. Garantir conformidade com RFC 7234.
Pilha de tecnologia
c
Domain
backend
Tipo Issue
Funcionalidade
DifficultyDificuldade de implementação estimada para um novo contribuidor, de 1 para alterações muito pequenas a 5 para trabalho de nível especializado.
4
Tempo estimadoUm intervalo de tempo aproximado para um colaborador experiente investigar, implementar, testar e preparar um pull request.
1-2 dias
Status da atividadeQuão disponível o issue aparece agora: novo, ativo, obsoleto, bloqueado ou aguardando entrada do mantenedor.
Ativo
ClarityCom que clareza o issue explica a mudança esperada, os critérios de aceitação e a próxima etapa.
Principalmente claro
Prerequisites
CHTTP cachingnginx internals
Simpatia para novatosUma pontuação de 1 a 100 que estima o quão acessível este issue é para colaboradores iniciantes.
40