Chrome网络日志CANCELLED事件排查：CSV下载失败原因分析

正常请求与失败请求的核心差异 #

• 正常请求：完整走完HTTP请求流程——在HTTP_STREAM_PARSER_READ_HEADERS阶段完成响应头解析后，成功收到服务器返回的200状态码，后续可正常接收文件内容并触发下载流程。
• 失败请求：在HTTP请求的任一环节（连接建立、请求发送、等待响应头部）被提前终止，未进入接收200响应的步骤，直接触发Chrome的CANCELLED事件，导致下载中断。

Chrome请求触发CANCELLED事件的常见原因 #

前端/框架层面 #

• 用户操作中断：请求未完成时，用户执行刷新页面、跳转路由、重复点击下载按钮等操作，浏览器主动取消未完成请求。
• Vaadin框架状态异常：Vaadin下载组件依赖会话状态，若会话超时、UI树重新渲染时未保留请求上下文，可能导致请求被框架内部取消；使用StreamResource生成下载链接时，资源生成逻辑的竞态条件也可能引发请求中途终止。
• 前端代码竞态：页面存在重复触发下载的逻辑，新请求触发时主动取消了未完成的旧请求。

网络/服务器层面 #

• 防火墙/代理拦截：防火墙或代理服务器对请求频率、内容大小、特征进行检测，偶尔触发拦截规则，直接中断TCP连接，标记请求为CANCELLED。
• 服务器主动终止：服务器因超时、资源耗尽、进程异常等原因，提前关闭与客户端的连接，导致请求未完成即中断。
• 网络波动：客户端网络临时断开、TCP连接重置，请求无法继续完成。

浏览器/系统层面 #

• 浏览器插件干扰：Chrome的安全插件、广告拦截器误将下载请求判定为非必要或风险资源，主动取消请求。
• 下载管理器异常：浏览器下载管理器因磁盘空间不足、队列异常等终止请求；Chrome网络进程临时故障，导致请求无法正常处理而被取消。

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