Nginx Mirror指令请求复制不完整，异步复制逻辑是否有误？

1. 对mirror指令异步机制的理解纠正 #

你的理解存在部分偏差：Nginx的mirror指令确实是异步发起镜像请求（即Nginx不会等待镜像请求的响应再返回主请求结果给客户端），但它并非完全脱离主请求的生命周期——镜像请求的触发有前提：必须等主请求完成请求体的读取（当mirror_request_body on时），并且主请求进入代理转发阶段后，才会发起镜像请求。

如果主请求在读取请求体阶段就失败（比如客户端断开连接、请求格式错误返回4xx），Nginx不会触发镜像请求。

2. 镜像端请求数少于主环境的原因分析 #

结合你提供的日志和配置，核心原因如下：

• 你开启了mirror_request_body on，这要求Nginx先完整接收主请求的请求体，才能复制并发送给镜像端。如果客户端在发送请求体的过程中超时断开（比如你日志中那条耗时27.912s的POST请求，状态码400），或者Nginx解析请求时直接返回错误（如请求格式非法），此时主请求还没完成请求体的读取，镜像请求就不会被触发。
• 那条异常日志中的请求POST /v1/before返回400状态，大概率是请求本身存在问题（比如请求体不完整、请求头格式错误），导致Nginx在处理主请求的早期阶段就终止了流程，没有进入到触发镜像的环节。

3. 排查与解决方案 #

• 检查异常请求日志：针对主环境中没有对应镜像请求的日志（比如状态码4xx/5xx、请求时间过长的条目），分析是否是请求体读取失败、客户端断开等原因导致镜像未触发。
• 调整超时配置：增加客户端相关超时时间，避免因客户端提前断开导致请求体读取不完整：

  client_header_timeout 60s;
  client_body_timeout 60s;
  

• 按需调整mirror_request_body配置：如果你的镜像端不需要请求体，可以设置mirror_request_body off，这样Nginx不需要等待读取完整请求体就能触发镜像请求，但镜像请求会不带请求体。
• 利用子请求日志排查：你已经开启了log_subrequest on，可以直接在访问日志中查看镜像子请求的记录（子请求的uri是/mirror/new），对比主请求日志，定位哪些主请求没有对应的镜像子请求。
• 修正统计命令：你当前的统计命令只针对/v1/legacy和/v1/new，但异常日志是/v1/before，建议调整统计规则覆盖所有可能的主请求路径，确保统计的准确性。

内容的提问来源于stack exchange，提问作者lulu_39