企业官网建设流程全解析

1、报错含义

ERR_INCOMPLETE_CHUNKED_ENCODING：分块传输编码不完整服务端用Transfer-Encoding: chunked流式返回数据，但连接中途被强制断开，浏览器没收到完整数据块，接口直接失败。

2、常见根因（按排查优先级排序）

1. 后端服务异常（最高概率）

1. 接口代码抛异常崩溃findEnum/ loginMenu内部逻辑报错（空指针、SQL 超时、循环死锁、OOM 内存溢出），服务进程 / 线程直接中断 TCP 连接，没输出结束 chunk 标识。
2. 接口执行超时
   • 数据库查询慢、大量枚举 / 菜单数据一次性加载耗时过长
   • Nginx、Tomcat、SpringBoot 超时阈值太短（默认 60s/30s），网关主动切断长请求
3. 服务内存 / CPU 打满JVM 堆溢出、服务器 CPU100%，无法完成数据输出，强制断连。

2. 反向代理 / Nginx 配置问题

1. Nginxproxy_buffer缓冲区过小，大报文溢出直接断流；
2. proxy_read_timeout、proxy_send_timeout超时时间太短；
3. 开启 gzip+chunked 冲突、代理转发时未完整透传流数据。

3. 前端请求层面

1. 前端主动取消请求：页面切换、路由跳转、组件销毁时axios.cancelToken中断请求；
2. 并发请求过多，浏览器 / 服务端限流丢弃连接；
3. 本地网络波动、VPN / 代理软件中断 TCP 链路。

4. 服务器 / 网络层

防火墙、安全组、WAF 拦截长连接，认为流量异常主动断开； 容器（Docker/K8s）资源限制，OOM kill 掉服务进程。

3、快速临时验证手段

• Postman 直接调用接口：绕过前端，单独请求报错接口
  • 如果 Postman 也报错 → 后端 / 网关问题；
  • 如果 Postman 正常、仅浏览器报错 → 前端主动取消或浏览器网络限制。
• 简化接口返回：临时让接口只返回少量测试数据，若不再报错，证明是数据量大 / 执行慢导致。

4、NGINX解决方案

修改点

报错本质：chunked 流式响应被中途切断，分两类配置要改：

1. 超时时间（读取后端数据、转发超时拉长）
2. 代理缓冲区（大 json / 菜单枚举数据缓冲不足）

修改配置

业务反向代理一般写在conf.d/你的项目.conf里。找到类似下面的location代理后端服务的代码块，所有修改写在location / { ... }内部。

location / { proxy_pass http://127.0.0.1:8080; # 你的后端地址不要改 # ========== 新增/修改以下所有配置 ========== # 连接后端超时 proxy_connect_timeout 300s; # 从后端读取响应超时（关键！菜单/枚举加载慢就调大） proxy_read_timeout 300s; # 向后端发送请求超时 proxy_send_timeout 300s; # 调大缓冲区，解决大json chunk截断 proxy_buffer_size 256k; proxy_buffers 8 128k; proxy_busy_buffers_size 256k; # 关闭缓冲，强制流式完整输出（chunked专用） proxy_cache off; proxy_buffering off; # 透传真实请求头（保留原有） proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; }

最小配置

proxy_read_timeout 300s; proxy_buffer_size 256k; proxy_buffers 8 128k; proxy_buffering off;