缓存键设计怎么包含请求协议与主机名区分环境

风婷吖_5241

风婷吖_5241

2026-09-22

126人浏览

原创

必须包含$scheme和$host,是为了隔离不同协议和域名的缓存,避免开发环境与生产环境响应互相覆盖,确保http://dev.example.com和https://prod.example.com同路径请求生成独立缓存条目。

缓存键设计怎么包含请求协议与主机名区分环境

缓存键里加入请求协议($scheme)和主机名($host),最直接的作用就是让不同环境的响应互不干扰——比如 http://dev.example.com 和 https://prod.example.com 即使请求路径完全一样,也会生成两个独立的缓存条目。

为什么必须包含 $scheme 和 $host

很多团队在测试环境和生产环境共用同一套 Nginx 配置,但后端返回的内容可能不同:开发环境返回调试信息、Mock 数据或未压缩资源,而生产环境返回精简版、带 CDN 域名的链接或真实用户数据。如果缓存键只用 $request_uri,就可能出现:

  • 用户在 HTTPS 生产站访问 /api/user,Nginx 缓存了带真实头像 URL 的响应;
  • 随后开发人员用 HTTP 访问同一路径做调试,Nginx 错误地返回了之前缓存的生产响应;
  • 结果是开发看到“线上数据”,或用户看到“本地调试内容”,造成数据错乱或安全泄露。

标准写法与常见变体

推荐的基础缓存键配置如下:

Nginx Reverse Proxy
Nginx Reverse Proxy

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

下载
proxy_cache_key "$scheme$host$request_uri";

这个组合已覆盖协议、域名、完整路径(含查询参数),适合绝大多数多环境部署场景。如需进一步区分,可考虑:

  • 加请求方法:对 POST/PUT 等非幂等请求,默认不应缓存;若确需缓存(如某些只读 API),加上 $request_method 可避免 GET 和 POST 冲突;
  • 排除特定查询参数:如 utm_source 或 ref 这类仅用于追踪的参数,可用 $args 配合 map 指令清洗后再拼入缓存键,防止缓存碎片化;
  • 按子域名隔离:若 admin.example.com 和 www.example.com 后端逻辑不同,$host 已天然支持区分,无需额外处理。

验证是否生效的小技巧

上线新缓存键后,可通过以下方式快速确认:

  • 在 Nginx 日志中启用 $upstream_cache_status,观察不同协议/域名下的请求是否分别命中 HIT 或各自 MISSED;
  • 用 curl -I http://dev.example.com/a 和 curl -I https://prod.example.com/a 对比响应头中的 X-Cache-Status(需自定义日志格式);
  • 检查磁盘缓存目录下文件名哈希:Nginx 实际存储的文件名由缓存键 MD5 生成,不同 $scheme$host 组合必然对应不同哈希前缀。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

nginx

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

2026.11.17

0

15

GoFrame框架安装与gf命令行工具
GoFrame框架安装与gf命令行工具

本专题围绕GoFrame框架的安装与工具链配置展开,讲清Go版本要求、gf命令行的安装方式、代理镜像与依赖准备,说明项目初始化、热编译、交叉编译打包的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.17

0

15

GoFrame框架零基础入门
GoFrame框架零基础入门

本专题整理GoFrame框架的入门知识,从模块化设计理念、环境准备到跑通第一个Web服务,讲清目录分层、配置加载、日志与中间件的用法,并对比Gin、Go-Zero的差异,帮助Go开发者建立整体认知。

2026.11.17

0

15

SQLAlchemy 一对多关系怎么建立
SQLAlchemy 一对多关系怎么建立

SQLAlchemy 一对多关系怎么建立?本专题整理父子表外键、relationship 双向映射、关联查询、级联删除和加载优化等相关文章,帮助你理解并实现常见的 ORM 关系建模。

2026.11.17

0

10

SQLAlchemy 如何增删改查
SQLAlchemy 如何增删改查

SQLAlchemy 如何增删改查?本专题整理 ORM 新增记录、条件查询、更新和删除、Session 事务提交与批量处理等实用文章,帮助你掌握 Python 数据库操作流程。

2026.11.17

0

11

SQLAlchemy ORM 模型怎么写
SQLAlchemy ORM 模型怎么写

SQLAlchemy ORM 模型怎么写?本专题整理模型类定义、Mapped 字段映射、主键与约束、表结构创建和常见报错的相关文章,帮助你从基础配置到实际建模逐步掌握 SQLAlchemy。

2026.11.17

0

16

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

2026.11.12

160

15

Go-Zero安装与goctl环境配置教程
Go-Zero安装与goctl环境配置教程

本专题围绕Go-Zero的安装与工具链配置展开,讲清Go版本要求、goctl安装方式、代理镜像、protoc依赖与环境变量设置,说明多版本共存、升级回退与CI流水线安装的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.12

120

15

Go-Zero零基础入门教程
Go-Zero零基础入门教程

本专题整理Go-Zero的入门知识,从框架定位、环境准备到跑通第一个API服务,讲清目录分层、配置加载、日志与中间件的基本用法,并对比Gin、Kratos的差异,帮助Go开发者建立整体认知,判断它是否适合当前项目。

2026.11.12

100

15

热门下载

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

精品课程

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

共0课时 | 0人学习

nginx手册
nginx手册

共0课时 | 0人学习

进程与SOCKET
进程与SOCKET

共6课时 | 0.5万人学习