Nginx 中怎么配置 proxy_cache 忽略 URL 中的时间戳参数-Nginx-PHP中文网

Nginx proxy_cache忽略时间戳参数的关键是在proxy_cache_key中使用map预处理$clean_uri剔除t/ts/_t/timestamp等参数，保留其他查询参数，使不同时间戳请求命中同一缓存条目。

nginx 中怎么配置 proxy_cache 忽略 url 中的时间戳参数

要让 Nginx 的 proxy_cache 忽略 URL 中的时间戳参数（比如 ?t=1728417740 或 &_ts=123456789），关键不是“删除参数”，而是**在构造缓存键（proxy_cache_key）时主动剔除这些干扰项**，使带参和不带参的请求映射到同一个缓存条目。

用 map 预处理请求 URI，剥离时间戳参数

直接在 http 块中定义一个 map，从 $request_uri 中移除常见的时间戳类参数（如 t、ts、_t、timestamp 等）：

map $request_uri $clean_uri {
    ~^(?<base>[^?]*)(\?.*)?$ $base;
    ~^(?<base>[^?]*)(\?(.*&|))t=[^&]*(?:&(.*)|)$ $base?$3;
    ~^(?<base>[^?]*)(\?(.*&|))ts=[^&]*(?:&(.*)|)$ $base?$3;
    ~^(?<base>[^?]*)(\?(.*&|))_t=[^&]*(?:&(.*)|)$ $base?$3;
    ~^(?<base>[^?]*)(\?(.*&|))timestamp=[^&]*(?:&(.*)|)$ $base?$3;
    default $request_uri;
}

这个 map 会生成一个干净的 $clean_uri 变量，不含指定的时间戳参数。注意它保留了其他有效查询参数（如 ?id=123&page=2），只剔除目标参数。

在 location 中使用 clean_uri 构造缓存键

在需要缓存的 location 块中，用 $clean_uri 替代原始 $request_uri：

aperture: the L402 aware reverse proxy

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

下载

location /api/ {
    proxy_pass http://backend;
    proxy_cache my_cache;
<pre class="brush:php;toolbar:false;"># 关键：用清理后的 URI 作为缓存键主体
proxy_cache_key "$scheme$request_method$host$clean_uri";

proxy_cache_valid 200 302 10m;
proxy_cache_valid 404 1m;
add_header X-Cache-Status $upstream_cache_status;

}

这样，/api/data?t=123 和 /api/data?t=456 就会共用同一个缓存条目，真正实现“忽略时间戳”。

补充建议：避免参数干扰的通用做法

若时间戳参数名固定（如统一用 _t），也可用 rewrite 在进入缓存逻辑前重写 URI，但 map 更轻量、无副作用
不要依赖 proxy_ignore_headers 或 proxy_cache_bypass 来解决这个问题——它们控制的是是否进缓存，而非“如何归一化请求”
配合 log_format 记录 $clean_uri 和 $request_uri，便于验证剥离是否生效
如果后端还依赖某些参数做日志或监控，可在 proxy_set_header 中单独透传，不影响缓存键设计