讲师中心 微信公众号

工具推荐

视频效率加速
updream

一键生成高质量推广成片

AniShort
AniShort

AI短剧协同制作平台

Laper
Laper

剧本策划到成片协作

SoundView
SoundView

字幕擦除翻译、配音口型同步

Nginx 缓存键设计如何配置按请求方法区分缓存

陌磊君_9536

陌磊君_9536

发布时间:2026-11-20 12:15:04

|

657人浏览过

|

来源于php中文网

原创

在 nginx 中配置按请求方法区分缓存,核心在于修改 proxy_cache_key 指令,将内置变量 $request_method 加入键值字符串中。这样当请求方法(如 get 与 post)不同时,nginx 会生成不同的缓存键,从而在磁盘或内存中存储独立的缓存文件,实现基于方法的隔离。

Nginx 缓存键设计如何配置按请求方法区分缓存

如何构建包含请求方法的缓存键

要实现这一目标,需要在 location 块中显式定义 proxy_cache_key。默认情况下,Nginx 的缓存键通常只包含 $scheme、$proxy_host 和 $request_uri,这意味着无论使用 GET 还是 POST 请求同一个 URL,都会命中同一个缓存。通过追加 -$request_method,可以确保不同方法的请求拥有唯一的标识符。

Nginx 缓存键设计如何配置按请求方法区分缓存

server {
    listen 80;
    server_name example.com;

    # 定义缓存路径、名称和参数
    proxy_cache_path /var/cache/nginx levels=1:2 keys_zone=my_cache:10m max_size=1g inactive=60m use_temp_path=off;

    location /api/ {
        proxy_pass http://backend;

        # 启用缓存
        proxy_cache my_cache;

        # 关键配置:将请求方法加入缓存键
        proxy_cache_key "$scheme$proxy_host$request_method$request_uri";

        # 设置缓存过期时间
        proxy_cache_valid 200 302 10m;
        proxy_cache_valid 404 1m;
    }
}

在上述配置中,proxy_cache_key 的值由四部分组成:$scheme(协议)、$proxy_host(后端主机)、$request_method(请求方法)和 $request_uri(完整 URI)。这种组合方式确保了即使 URI 相同,只要请求方法不同,生成的哈希值就会不同,进而指向不同的缓存条目。例如,GET /api/data 和 POST /api/data 将被视为两个完全不同的资源进行缓存。

Nginx Reverse Proxy
Nginx Reverse Proxy

配置 Nginx 反向代理,实现域名绑定。用户说“绑定域名”“配置 Nginx”“反向代理”时触发,将域名绑定到指定 IP:端口。

下载

如何处理动态内容与非缓存请求

并非所有请求都适合缓存,尤其是涉及状态变更的 POST、PUT 或 DELETE 请求。虽然通过 proxy_cache_key 可以将它们与 GET 请求区分开并单独缓存,但在大多数业务场景下,写操作的结果不应被缓存返回给客户端,或者需要更严格的控制。可以通过 proxy_no_cache 和 proxy_cache_bypass 指令来进一步细化行为,或者直接针对特定方法禁用缓存。

Nginx 缓存键设计如何配置按请求方法区分缓存

location /api/ {
    proxy_pass http://backend;
    proxy_cache my_cache;
    proxy_cache_key "$scheme$proxy_host$request_method$request_uri";

    # 针对非 GET 请求禁用缓存
    if ($request_method !~ ^(GET|HEAD)$) {
        proxy_cache off;
    }

    # 或者,仅对 GET 请求启用缓存,其他方法不缓存
    # proxy_cache_methods GET HEAD;
}

在实际应用中,如果希望严格区分且不对写操作进行缓存,可以在上述配置基础上增加逻辑判断。Nginx 的 if 指令结合 $request_method 变量可以精确匹配请求类型。当检测到非 GET 或 HEAD 请求时,通过 proxy_cache off; 关闭当前位置的缓存功能,确保这些请求直接转发到后端服务器,不会写入缓存目录。这种方式既保留了 GET 请求的高效缓存,又避免了因缓存键区分而导致的写操作缓存污染问题。此外,还可以使用 proxy_cache_methods 指令(Nginx 1.7.2+)来明确指定哪些 HTTP 方法可以被缓存,这是一种更简洁且官方推荐的做法,无需编写复杂的 if 逻辑。

基于 $request_method 变量的具体行为验证

为了验证 $request_method 在缓存键中的作用,我们可以观察同一 URI 在不同方法下的缓存命中情况。假设后端服务对于 GET /api/item 返回数据 A,对于 POST /api/item 返回确认信息 B。在没有配置 $request_method 时,先发起 GET 请求,Nginx 缓存该响应;随后发起 POST 请求,由于 URI 相同,Nginx 可能会错误地返回之前缓存的数据 A,导致业务逻辑错误。引入 $request_method 后,POST 请求生成新的缓存键,Nginx 会将后端的响应 B 缓存起来,并返回给客户端,从而保证了数据的正确性。

热门AI工具

更多
Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

相关专题

更多
nginx 重启
nginx 重启

nginx重启对于网站的运维来说是非常重要的,根据不同的需求,可以选择简单重启、平滑重启或定时重启等方式。本专题为大家提供nginx重启的相关的文章、下载、课程内容,供大家免费下载体验。

423

2023.07.27

nginx 配置详解
nginx 配置详解

Nginx的配置是指设置和调整Nginx服务器的行为和功能的过程。通过配置文件,可以定义虚拟主机、HTTP请求处理、反向代理、缓存和负载均衡等功能。Nginx的配置语法简洁而强大,允许管理员根据自己的需要进行灵活的调整。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

4387

2023.08.04

nginx配置详解
nginx配置详解

NGINX与其他服务类似,因为它具有以特定格式编写的基于文本的配置文件。本专题为大家提供nginx配置相关的文章,大家可以免费学习。

7365

2023.08.04

tomcat和nginx有哪些区别
tomcat和nginx有哪些区别

tomcat和nginx的区别:1、应用领域;2、性能;3、功能;4、配置;5、安全性;6、扩展性;7、部署复杂性;8、社区支持;9、成本;10、日志管理。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

601

2024.02.23

nginx报404怎么解决
nginx报404怎么解决

当访问 nginx 网页服务器时遇到 404 错误,表明服务器无法找到请求资源,可以通过以下步骤解决:1. 检查文件是否存在且路径正确;2. 检查文件权限并更改为 644 或 755;3. 检查 nginx 配置,确保根目录设置正确、没有冲突配置等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1516

2024.07.09

Nginx报404错误解决方法
Nginx报404错误解决方法

解决方法:只需要加上这段配置:try_files $uri $uri/ /index.html;即可。想了解更多Nginx的相关内容,可以阅读本专题下面的文章。

4018

2024.08.07

nginx部署php项目教程汇总
nginx部署php项目教程汇总

本专题整合了nginx部署php项目教程汇总,阅读专题下面的文章了解更多详细内容。

122

2026.01.13

nginx配置文件详细教程
nginx配置文件详细教程

本专题整合了nginx配置文件相关教程详细汇总,阅读专题下面的文章了解更多详细内容。

617

2026.01.13

Nginx CVE-2026-123007排查与防护指南
Nginx CVE-2026-123007排查与防护指南

Nginx HTTP/2漏洞该怎么修复?本专题围绕CVE-2026-123007,介绍安全版本升级、模块兼容检查和配置恢复方法,以及日志排查、权限设置等后续加固操作,方便你按实际部署情况查找对应教程。

0

2026.11.20

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
phpEnv手册
phpEnv手册

共0课时 | 0人学习

nginx手册
nginx手册

共0课时 | 0人学习

进程与SOCKET
进程与SOCKET

共6课时 | 0.5万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn