GraphQL常通过同一个地址承载多种查询。若CDN只按这个地址保存响应,一次商品查询与一次用户资料查询就可能被错误看成同一个对象。缓存设计必须理解操作与变量,而不只是路径。

先确认实际HTTP方法
GraphQL官方HTTP指南说明POST用于查询和mutation,GET可以用于查询操作,不能用于mutation。该指南也讨论了查询标识用于缩短请求的方式。服务端是否支持GET,应按实际实现确认。
不要把所有POST统一写成“理论上绝不可能缓存”,也不要在未了解平台支持和业务语义时强行开启POST缓存。默认采用清楚且受支持的路径,比定制一套含糊规则更容易验证。
查询标识不等于完整响应身份
同一个查询文档可以配合不同变量,也可以在不同账号下返回不同结果。持久化查询标识只是表达哪份操作,不能自动证明所有请求都可共享。
| 维度 | 需要判断 |
|---|---|
| 操作文档或标识 | 是否对应同一查询定义 |
| 变量 | 商品、分页、筛选等是否改变结果 |
| 身份与租户 | 是否包含专属或授权数据 |
| 版本与环境 | 查询定义和后端语义是否一致 |
| 结果状态 | 是否出现部分错误或不完整数据 |
先选择纯公开、边界明确的查询
例如只返回公开商品介绍且变量范围明确的查询,可以在验证后评估共享缓存。用户资料、购物车或权限相关字段则需要独立设计,不能因为同一操作里也包含公开字段就把整个响应公开。
缓存键不能存放原始访问令牌。若方案需要身份区分,应确认平台支持、授权位置和隔离机制;无法证明正确时,应让相应响应不进入共享缓存。
HTTP成功不等于GraphQL业务完整
GraphQL响应可能同时包含数据和错误信息。只依据HTTP状态缓存,可能让某次依赖失败产生的部分结果长期复用。应按应用定义明确哪些结果可以缓存、如何失效以及如何向用户说明。
查询复杂度和调用成本也需要单独限制。缓存可以降低重复请求的计算,但无法自动治理首次出现的大量不同查询,不能把命中率当成API资源保护的全部措施。
用变量和身份交叉验证
测试同一查询不同变量、同一变量不同身份、重复查询以及后端数据更新。记录实际返回字段和应用版本,确认不存在跨对象或跨租户复用。
对于查询标识的更新,安排客户端与服务端兼容窗口。旧客户端仍发送旧标识时,应有明确行为,不能悄悄把旧标识映射到语义不同的新查询。
接入API安全加速时,先提交可缓存查询清单,再确认边缘能否表达所需区分。一个接口地址只是传输入口,业务结果的身份需要由操作、变量与授权共同确定。
资料核对日期:2026年10月30日。本文由AI辅助整理,技术事实依据文内原始资料核对。示例与操作清单供实施参考;产品配置和软件维护状态以实施时的官方资料为准。
涉及漏洞与安全事件的文章,请结合文中来源、发布时间和厂商最新公告核对。产品配置与防护效果以实际业务验证为准;资料纠错可联系 support@waf.pro。
