nginx 无原生文本替换模块，所谓“sub_filter正则性能低”实为误用：sub_filter本身不支持正则，性能瓶颈多源于location/if/map等指令中低效正则匹配或响应缓冲开销。
Nginx 本身没有“文本替换模块”——你实际想排查的，是使用 sub_filter 指令（属于 ngx_http_sub_module）配合正则表达式（sub_filter 默认不支持正则，但若启用了 sub_filter_once off + 多次 sub_filter 或与 map/if 混用间接触发 PCRE）时出现的性能下降；更常见的是把 sub_filter 误当作正则替换工具，而真正拖慢性能的其实是背后隐式调用的正则匹配逻辑（比如在 location、if、map 或 rewrite 中写的低效正则，恰好和响应体替换逻辑同路径执行）。
排查核心不是“sub_filter 多慢”，而是定位哪条正则在响应处理链路中被高频、低效执行。以下是可落地的排查路径：
确认是否真在用正则做响应替换
默认 `sub_filter` 只支持字面量替换（如 sub_filter "old" "new";），不支持正则语法。如果你写了类似 sub_filter "v\d+\.\w+" "latest";，它不会生效，也不会报错——只是静默跳过。所谓“正则替换性能低”，大概率是以下情况之一：
- 你在 `sub_filter` 外层套了 `if ($upstream_http_content_type ~ "text/html") { ... }`，而这个 `if` 的正则本身低效
- 你用 `map $upstream_http_content_type $do_sub { ~text/html 1; default ""; }` 做内容类型判断，但 `map` 中的正则未锚定或含 `.*`
- 你把 `sub_filter` 放在 `location ~ \.html$` 块里，而该 `location` 正则本身复杂（如 `~ ^/app/.*\.(html|htm)$`）
- 你误将 `sub_filter` 和 `rewrite` 混用，例如先 `rewrite` 修改 URI，再 `sub_filter` 处理响应，导致两次正则扫描
用日志差值快速定位本机处理瓶颈
Nginx 不记录 `sub_filter` 耗时，但能暴露整体瓶颈位置：
- 在
log_format中加入$request_time（总耗时）和$upstream_response_time（后端返回时间） - 若某类请求（如 HTML 页面）的
$request_time - $upstream_response_time > 30ms，说明 Nginx 本机处理（含 `sub_filter` 解析、变量展开、正则判断等）占主导 - 再加
$uri和$sent_http_content_type，聚合分析：是否所有text/html响应都慢？还是仅特定路径（如/blog/.*）？缩小范围
关闭 sub_filter 并隔离验证
这不是“禁用功能”，而是排除法：
- 临时注释掉所有
sub_filter、sub_filter_types、sub_filter_once指令 - 保持其他配置（尤其是 `location ~`、`if`、`map`）完全不变，压测相同 URL
- 对比
$request_time是否显著下降：若下降明显，问题就在 `sub_filter` 启用后触发的额外变量计算或条件判断；若无变化，瓶颈在别处（如上游响应慢、SSL 握手、或 location 匹配本身） - 注意：
sub_filter会强制缓冲响应体（sub_filter默认启用proxy_buffering on），若后端流式输出大 HTML，缓冲本身就会增加延迟
替代方案：用 map 预判 + 精确匹配规避运行时正则
真正高效的响应处理，应避免在每次响应时做正则判断：
- 不要写：
if ($upstream_http_content_type ~ "text/html") { sub_filter ...; } - 改用：
map $upstream_http_content_type $need_sub { ~*^text/html$ 1; default 0; }，再用sub_filter配合sub_filter_types text/html;（该指令本身不走正则，只查 MIME 类型字符串前缀） - 对需要替换的路径，优先用
location = /index.html或location ^~ /blog/承接，而非location ~ \.html$，减少正则匹配次数 - 静态 HTML 替换尽量前置：构建时替换（如 CI/CD 中 sed 替换版本号），而非运行时靠 Nginx
