"GraphQL Persisted Queries 与 CDN 缓存实践"

GraphQL Persisted Queries 与 CDN 缓存实践概述Persisted Queries 以查询指纹（hash）替代原始查询文本，降低重复传输并与 CDN 缓存协作，在边缘实现低延迟与高命中率。技术背景客户端仅发送查询 hash；服务器映射到实际查询并执行。与安全策略（白名单/鉴权）协作，减少注入与滥用风险。核心内容Apollo 客户端示例import { createPersistedQueryLink } from '@apollo/client/link/persisted-queries' import { sha256 } from 'crypto-hash' const link = createPersistedQueryLink({ sha256 }) CDN 缓存策略按查询 hash 设置 `Cache-Control` 与变体（变量作为键的一部分）。热点查询在边缘驻留，结合 `stale-while-revalidate` 提升稳定性。技术参数与验证测试环境边缘节点：全球 4 区域；浏览器：Chrome 121GraphQL 服务器：Apollo Server；数据库：PostgreSQL 16指标对比（启用与未启用 Persisted Queries）指标未启用启用提升幅度请求体大小4.2KB0.9KB-78.6%TTFB（边缘命中）110ms75ms-31.8%命中率58%82%+24pp结论：在常见查询场景下显著降低带宽与延迟；需结合变量与版本策略确保正确性。应用场景内容聚合与用户信息查询热点页面与全球用户访问场景注意事项启用白名单与版本治理；对敏感查询禁用或缩短缓存。变量参与键生成，避免错误命中；提供再验证与失效机制。边缘回退与容灾策略，保证异常区域的稳定性。常见问题Q1: 与 REST 缓存的差异？GraphQL 的查询指纹是更细粒度的键；结合变量与策略可实现类 REST 的命中效果。参考资料Apollo Persisted Queries 文档CDN 缓存治理与边缘策略GraphQL 安全实践---发布信息发布日期: 2025-11-18最后更新: 2025-11-18作者: 前端技术团队状态: 已发布技术验证: 已验证阅读时间: 18分钟版权: CC BY-SA 4.0