Nginx网关层用sub_filter动态注入前端调试脚本，实现无侵入缓存诊断：需启用模块、匹配响应类型、精准定位注入点、脚本具备缓存感知与安全灰度控制。
在 Nginx 网关层利用 sub_filter 动态注入前端调试脚本，是一种轻量、无侵入的缓存诊断方案。它不修改源站代码，也不依赖客户端配合，适合灰度验证、CDN 缓存策略排查或临时调试。
确保 sub_filter 基础能力可用
Nginx 默认不启用 sub_filter 的输出流替换功能，需确认以下几点：
- 使用的是 开源版 Nginx ≥ 1.9.4 或 Tengine（原生支持更稳定）；OpenResty 用户需注意部分版本默认关闭该模块，需编译时启用
--with-http_sub_module -
sub_filter仅对text/html、application/xhtml+xml等响应类型生效，且要求响应体未被压缩（即禁用gzip或设置sub_filter_once off时需搭配gzip off） - 必须开启
sub_filter_types *或显式列出text/html，否则默认只处理text/html，但 Content-Type 不匹配时会静默跳过
精准定位注入位置：避免破坏 HTML 结构
直接替换 或
