# 响应头<no value>

## X-Cache

指示响应的返回方式。

| 值 | 描述 |
|-------|-------------|
| `HIT` | 从缓存返回（新鲜） |
| `MISS` | 从源站获取并已缓存 |
| `STALE` | 从缓存返回（过期，在 stale-while-revalidate 或 stale-if-error 窗口内） |
| `BYPASS` | 绕过缓存（no-store、no-cache、路由禁用缓存，或 SSE 请求） |
| `REVALIDATED` | 向源站的条件请求返回 304，从缓存返回并更新新鲜度 |

```bash
curl -sI http://localhost:8080/get | grep x-cache
# X-Cache: HIT
```

## Age

缓存对象的年龄（秒），计算自原始响应的 `Date` 头加上在
上游转发代理中花费的时间。每次缓存命中时更新。

```bash
curl -sI http://localhost:8080/get | grep age
# Age: 42
```

## X-Cache-Source

指示由哪个存储层返回了响应。

| 值 | 描述 |
|-------|-------------|
| `hot` | 从 RAM 热层（L0）返回 |
| `warm` | 从 mmap 温层（L1）返回 |
| `peer` | 通过 peer fetch 从集群节点返回 |
| `origin` | 从上游源站获取 —— 自 v0.5.28 起也包括所有 BYPASS 路径（流式源站获取、SSE、upstream-in-process 回退） |
| _(空)_ | 非由存储层返回：bouine 自行合成的响应（only-if-cached 504、卸载 503、无 upstream 的 502）。自 v0.5.28 起，Prometheus `source` 标签将其呈现为 `bouine` 而非空字符串。 |

## 上游错误状态码（自 v0.5.29 起）

对 upstream pool 的 fetch 超时 —— 拨号超时、响应头超时或路由的
`cache.fetch_timeout` 截止时间 —— 以 `504 Gateway Timeout`
（RFC 9110 §15.6.5）返回客户端，响应体为 "upstream timeout"，并携带
常规的 `X-Cache` / `X-Cache-Source` 归因。其他所有上游失败（拒绝、
重置、DNS）仍返回 `502 Bad Gateway`。超时分类与
`bouine_origin_connection_errors_total` 的 reason 标签使用同一字符串，
因此线上状态码与指标一致。only-if-cached 504 与卸载 503 不受影响。

## X-Bouine-Route

匹配请求的路由标签。用于仪表板的逐路由归因与访问日志。它不再是
Prometheus 标签：自 v0.5.8 起，数据面 RED 指标改为按 `upstream_pool`
（由配置限定的小集合）归因，而非路由名；参见
[监控](/docs/operations/monitoring/#traffic-red)。

## X-Bouine-Pool

所服务路由的 upstream pool。由路由器以进程本地值的形式设置，被
指标中间件用作 `upstream_pool` Prometheus 标签；入站头形式原样
转发。无 pool 的路由（静态、catch-all）上报为 `_default`。