Nginx 中怎么配置 proxy_cache 缓存微服务架构下的聚合 API 响应-Nginx-PHP中文网

nginx proxy_cache可安全缓存聚合api响应，需精准识别可缓存读接口、设专用缓存区、按语义构造cache_key、分级设置有效期、启用stale与后台更新机制，并通过x-cache-status验证生效。

nginx 中怎么配置 proxy_cache 缓存微服务架构下的聚合 api 响应

在微服务网关中用 Nginx proxy_cache 缓存聚合 API 响应，关键不是缓存所有请求，而是精准识别“可缓存的读接口”，并规避身份态、参数噪声和后端干扰头带来的风险。聚合 API（如 /api/v1/summary）通常合并多个下游服务数据，本身无副作用、更新频率低、响应结构稳定——这正是缓存的理想对象。

专设缓存区，隔离聚合流量

聚合类响应需独立缓存空间，避免与静态资源或用户私有接口共用 zone：

在 http 块顶部声明专用路径和内存区：
proxy_cache_path /var/cache/nginx/agg_cache levels=1:2 keys_zone=agg_cache:64m max_size=2g inactive=5m use_temp_path=off;
keys_zone=agg_cache:64m 支撑约 50 万缓存 key，足够覆盖高频聚合路径；
inactive=5m 匹配聚合接口典型冷热周期（如订单汇总每 5 分钟刷新一次）；
use_temp_path=off 强制绕过临时文件拷贝，降低毫秒级延迟。

按路径+语义启用，跳过敏感上下文

聚合接口常带分页、时间范围等参数，但真正影响结果的只有核心维度（如 shop_id、date），其余应剔除：

aperture: the L402 aware reverse proxy

安装并运行 Aperture（Lightning Labs 的 L402 闪电反向代理），用于创建 L402 付费墙、配置付费 API 端点、为其他代理托管付费内容或测试 L402 认证流程。

下载

匹配聚合路径：
location ~ ^/api/v1/(summary|dashboard|report)/ {
启用缓存并定制键：
```
proxy_cache agg_cache;<br>proxy_cache_key "$host$uri$is_args$arg_shop_id$arg_date";
```
（只保留业务主键，忽略 page、ts、token 等无关参数）
显式跳过含认证信息的请求：
proxy_cache_bypass $http_authorization $arg_session_id;

分级设置有效期，兼顾新鲜与可用

聚合数据不追求实时，但也不能太旧。按状态码分层控制更稳妥：

proxy_cache_valid 200 302 3m; —— 正常响应缓存 3 分钟，平衡更新频次与命中率；
proxy_cache_valid 404 30s; —— 空数据缓存半分钟，防反复穿透；
proxy_cache_valid 500 502 503 1s; —— 后端异常时仅缓存 1 秒，避免陈旧错误长期滞留；
proxy_ignore_headers Cache-Control Expires Set-Cookie; —— 强制由 Nginx 控制生命周期，不被下游服务头干扰。

加兜底机制，保障故障期服务连续性

聚合接口依赖多个微服务，单点故障概率高，必须配置 stale 和后台刷新：

proxy_cache_use_stale error timeout updating http_500 http_502 http_503 http_504;
—— 任一后端超时或返回 5xx，仍返回刚过期的聚合结果；
proxy_cache_background_update on;
—— 返回 stale 数据的同时，后台静默拉取新数据，下次请求即命中新鲜内容；
proxy_cache_lock on; proxy_cache_lock_timeout 2s;
—— 防止同一聚合请求（如 /summary?shop_id=1001）并发击穿后端。

可观测与验证，确认缓存真实生效

上线后必须验证是否真缓存、缓存是否安全：

加响应头暴露状态：
add_header X-Cache-Status $upstream_cache_status;
用 curl -I https://api.example.com/api/v1/summary?shop_id=1001 查看是否返回 HIT；
测试 bypass 场景：带 Authorization 头访问，确认返回 MISS 或 BYPASS；
手动清理单个 key（调试用）：
proxy_cache_purge 指令配合自定义 purge location，或直接清磁盘目录（慎用）。