Java 下载文件没反应？常见原因

Java下载文件没反应，通常因请求未发出、响应未接收或前端未触发下载；需确认后端是否返回文件流（如ResponseEntity）并设置正确响应头（Content-Type、Content-Disposition），前端调用须配置responseType: 'blob'，且排除跨域拦截与流写入异常。

Java 下载文件没反应，通常不是代码完全失效，而是请求没发出去、响应没拿到、或前端没触发下载行为。重点先确认是后端没返回文件流，还是前端没正确处理响应。

后端返回类型或响应头不匹配

Spring Boot 等框架中，如果 Controller 返回的是 String 或 ModelAndView，而不是 ResponseEntity 或 InputStreamResource，浏览器根本收不到文件数据。还要检查关键响应头是否设置：

• Content-Type 应设为具体类型（如 application/vnd.ms-excel）或通用二进制类型（application/octet-stream）
• Content-Disposition 必须包含 attachment; filename="xxx.xlsx"，否则浏览器可能直接渲染而非下载
• Content-Length 建议设置，尤其大文件，避免前端无法判断进度

前端调用方式错误（常见于 AJAX）

用 fetch 或 axios 发送请求时，如果没配置 responseType: 'blob'，响应体默认是文本，后续 URL.createObjectURL() 就会失败或静默出错：

• axios 示例：axios.get('/api/download', { responseType: 'blob' }).then(...)
• fetch 示例：fetch('/api/download').then(r => r.blob()).then(blob => {...})
• 千万别用普通 AJAX（如 jQuery $.get）直接请求下载接口——它不支持 blob 响应解析

跨域或拦截导致请求被阻断

前后端分离部署时，若后端没开启 CORS，或 Nginx/网关层拦截了非简单请求（比如带自定义 header），请求可能 0 字节返回，控制台却无明显报错：

标签： excel java jquery 前端 ajax nginx cookie 浏览器 app 字节 access axi