根本原因是Nginx默认在客户端断开时立即向后端发送FIN/RST中断连接；proxy_ignore_client_abort on必须配合proxy_read_timeout、proxy_send_timeout、proxy_connect_timeout、proxy_buffering off及proxy_http_version 1.1等设置才生效。

为什么移动端弱网下后端任务会被“误杀”

根本原因是 Nginx 默认行为太“敏感”：只要客户端断开（比如用户切后台、滑回上一页、地铁里信号消失），Nginx 就立刻向后端发 FIN/RST，强制中止连接 —— 即便后端 Flask 或 Spring Boot 正在生成报表、处理上传、写数据库，也会被中断。日志里常看到 499 状态码，但更隐蔽的问题是后端抛 ClientAbortException 或任务半途而废。

proxy_ignore_client_abort on 必须配合哪些参数才真正生效

单独加 proxy_ignore_client_abort on 很可能没用，Nginx 会自己先超时断掉后端连接。必须同步调整以下超时与缓冲设置：

• proxy_read_timeout 和 proxy_send_timeout 要设为后端任务最大耗时（例如 300 秒），否则 Nginx 在等待响应时主动断连，记 504
• proxy_connect_timeout 建议设为 60，避免握手阶段就被拦
• proxy_buffering off 必须关闭，否则流式响应（如 SSE、大文件下载）会被缓存截断
• proxy_http_version 1.1 + proxy_set_header Connection '' 防止 keepalive 连接池复用异常

只在特定 location 中启用，别全局开

这个配置不是“越开越稳”，而是有明确适用边界的：

WebChat Voice Proxy

⚠️ 已弃用 — 该技能已拆分为两个独立技能，以提升模块化程度：**webchat-https-proxy**（HTTPS/WSS 反向代理）和 **webchat-voi...**

下载

• 适合：/api/report/generate、/api/upload/process 这类耗时 >1s 且幂等/可追踪的异步任务接口
• 不适合：/login、/pay/confirm 等敏感操作 —— 客户端取消支付请求，你还硬转给后端，可能造成重复扣款
• 不要放在 http 或 server 块顶层，避免影响所有流量；只加在具体 location 块内

开了之后后端要做什么配套改造

proxy_ignore_client_abort on 只解决 Nginx 层“不甩手”，不解决后端自身脆弱性：

• 后端必须能捕获并忽略写响应时的 I/O 异常（如 Tomcat 的 ClientAbortException），否则日志刷屏、线程卡死
• 关键任务需自带状态机（例如 DB 存 status: processing），前端通过轮询 /task/status?id=xxx 查结果，而不是傻等响应
• 避免在 response.getOutputStream() 上直接写 —— 这类操作一旦连接断开必抛异常；优先用框架封装好的响应体机制

最容易被忽略的一点：这个配置对 DNS 失败、TCP 握手失败、SSL 协商失败完全无效，它只响应“已建立连接后的客户端静默断开”。如果你看到大量 499 却没对应后端日志，先确认是不是网络层根本没连上，而不是急着开 proxy_ignore_client_abort。