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 字节返回，控制台却无明显报错：

• 检查浏览器 Network 面板：请求状态码是否为 200？Size 是否为 0？Preview/Response 是否为空？
• 后端需允许 Content-Disposition 等响应头透传：Access-Control-Expose-Headers: Content-Disposition
• 避免在下载请求中携带未授权的 Cookie 或 Token（除非明确配置了 withCredentials: true 且后端支持）

文件流未正确关闭或写入异常

手动用 ServletOutputStream 或 OutputStream 写文件时，容易忽略异常捕获或流未 flush/flush 失败：

• 务必在 try-with-resources 或 finally 中关闭输出流
• 写入后调用 response.getOutputStream().flush()，尤其 Tomcat 有时缓冲导致卡住
• 日志里加一句 log.info("已写入 {} 字节", count)，确认后端确实执行到了写入逻辑

基本上就这些。先看 Network，再查后端日志，最后验证前端 blob 处理逻辑——90% 的“没反应”都卡在这三步里。