Nginx 可通过 sub_filter 动态替换 JSON 响应体中的 URL 路径，需配置 sub_filter_types application/json、启用响应缓冲、精准匹配带引号字段值、处理转义及禁用 gzip 压缩以确保生效。
可以通过 Nginx 的 sub_filter 指令在反向代理响应体中动态替换 JSON 字段里的 URL 路径，实现负载均衡层对后端返回资源路径的透明修正。关键在于正确配置 MIME 类型匹配、启用响应体缓冲、处理 JSON 特殊字符及避免误替换。
确保响应可被 sub_filter 处理
Nginx 默认只对 text/html 响应启用 sub_filter，而 JSON 通常返回 application/json。需显式添加类型支持：
- 在
http或location块中添加：sub_filter_types application/json; - 必须开启响应体缓冲：
sub_filter_once off;（允许多次替换）或on（仅首处） - 启用输出过滤：
sub_filter "" "";是无效写法，至少要有一个非空替换对，例如sub_filter "https://api-v1.example.com" "https://api.example.com";
精准匹配 JSON 中的字段值（避免误伤）
JSON 是纯文本，sub_filter 不解析结构，直接字符串替换。为降低风险：
- 用带引号和冒号的完整模式提高准确性，例如：
sub_filter "\"avatar_url\":\"https://old.domain.com" "\"avatar_url\":\"https://new.domain.com"; - 若路径出现在多个字段（如
image_url、logo），可多次使用sub_filter，每行一条 - 注意转义：Nginx 配置中双引号需用反斜杠转义，正则不支持，所以不能写成
"url":\s*"[^"]*"
处理 gzip 压缩与编码兼容性
若后端返回 gzip 压缩的 JSON，sub_filter 将失效（因未解压）：
- 在 upstream 或 proxy location 中禁用后端压缩：
proxy_set_header Accept-Encoding ""; - 或让 Nginx 自动解压再过滤（需编译时含
--with-http_gzip_static_module并配置gunzip on;） - 确认字符编码一致，避免 UTF-8 BOM 或混合编码导致匹配失败
验证与调试技巧
替换是否生效需实测响应体内容：
- 临时关闭缓存：
proxy_buffering off;+proxy_cache off; - 用
curl -H "Accept: application/json" http://your-lb/api/user直接查看原始响应 - 开启 Nginx 错误日志到 info 级：
error_log /var/log/nginx/subfilter.log info;（部分版本支持记录 sub_filter 匹配行为） - 注意：sub_filter 不影响 HTTP 头、状态码或非匹配内容，仅修改响应体中的指定字符串
