Nginx需在location块中配置mirror指令实现特定接口流量镜像：用^~ /api/匹配路径，启用mirror /mirror-api、mirror_request_body on和限速；/mirror-api须设为internal并proxy_pass至镜像后端，清除敏感头，单独记录镜像日志，最后验证主流程正常且镜像日志生成。
要让 Nginx 的 server 块只对特定接口（例如 /api/v1/users）做流量镜像，关键不是按“接口”字面匹配路径，而是通过 location 精准拦截该路径，并启用 mirror 指令复制请求——主流程完全不受影响，镜像请求异步发往独立后端用于监控分析。
在目标 location 中启用 mirror 指令
镜像必须绑定到具体路径，不能写在 server 块顶层。例如监控所有 /api/ 开头的请求：
- 使用
location ^~ /api/ { mirror /mirror-api; }，^~确保前缀匹配优先于正则，避免误触其他规则 - 必须添加
mirror_request_body on;，否则 POST、PUT 等带 body 的请求只镜像 headers，丢弃数据 - 建议加限速保护镜像后端：
mirror_rate_limit 300r/s;（按实际压测调整）
定义内部 mirror 路由并转发
/mirror-api 是你自定义的内部中转路径，需严格限制访问权限：
- 用
location = /mirror-api { internal; }声明为内部路径，外部无法直接 curl 访问 - 在该 location 内配置
proxy_pass http://mirror-backend$request_uri;，保留原始 URI 和 query 参数 - 清除敏感头：
proxy_set_header Authorization "";、proxy_set_header Cookie "";，防止测试环境泄露凭证
隔离日志便于定位问题
主业务日志和镜像日志混在一起会干扰排查，建议单独记录：
- 定义专用日志格式：
log_format mirror_log '$time_iso8601 "$request" $status $body_bytes_sent $request_time'; - 在
location = /mirror-api中指定：access_log /var/log/nginx/mirror-access.log mirror_log; - 避免使用
off或复用main日志，确保镜像行为可审计
验证镜像是否生效且主流程正常
配置完成后重点确认两点：主服务响应没变慢、镜像请求确实发出：
- 执行
nginx -t && nginx -s reload检查语法并热重载 - 用
curl -X POST http://your-domain.com/api/v1/users -d '{"name":"test"}'触发请求，观察返回是否仍为 200/201，延迟无明显升高 - 立刻检查
/var/log/nginx/mirror-access.log是否新增对应条目，确认 method、path、status 字段匹配
