Servlet生成Excel文件下载难题：需同时返回错误码

我之前在做类似的Excel下载功能时也踩过这个坑，刚好能给你几个实用的解决方案，完美兼顾文件下载和错误状态处理的需求：

方案一：用XMLHttpRequest手动处理二进制响应（推荐无跳转场景） #

$.get默认会把响应当成文本解析，所以拿到的是乱码的Excel数据，我们需要用原生XMLHttpRequest指定响应类型为blob，这样就能正确处理二进制文件，同时还能获取响应状态码。

前端代码示例： #

const downloadExcel = () => {
  const xhr = new XMLHttpRequest();
  xhr.open('GET', `${webContextPath}/backend_url`, true);
  // 关键：指定响应为二进制Blob类型
  xhr.responseType = 'blob';

  xhr.onload = function() {
    // 判断响应状态码
    if (xhr.status === 200) {
      // 将Blob数据转为可下载的链接
      const blob = new Blob([xhr.response], { 
        type: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' 
      });
      const downloadUrl = window.URL.createObjectURL(blob);
      const aTag = document.createElement('a');
      
      aTag.href = downloadUrl;
      aTag.download = '导出数据.xlsx'; // 设置下载的文件名
      document.body.appendChild(aTag);
      aTag.click(); // 触发下载
      
      // 清理临时资源
      window.URL.revokeObjectURL(downloadUrl);
      document.body.removeChild(aTag);
    } else {
      // 处理错误：解析错误响应内容
      xhr.response.text().then(errorText => {
        try {
          // 如果后端返回JSON格式的错误信息
          const errorData = JSON.parse(errorText);
          alert(`下载失败：${errorData.msg}`);
        } catch (e) {
          // 否则直接显示状态码和原始文本
          alert(`下载失败，状态码：${xhr.status}，信息：${errorText}`);
        }
      });
    }
  };

  xhr.onerror = function() {
    alert('请求出错，请检查网络或稍后重试');
  };

  xhr.send();
};

// 调用下载函数
downloadExcel();

后端Servlet配合： #

• 成功时：正常输出Excel二进制流，设置正确的Content-Type和Content-Disposition头
• 失败时：设置对应的错误状态码（如400、500），并返回JSON或文本格式的错误信息

// 示例：Servlet中的错误处理逻辑
if (参数验证失败) {
  response.setStatus(HttpServletResponse.SC_BAD_REQUEST);
  response.setContentType("application/json;charset=utf-8");
  response.getWriter().write("{\"msg\":\"参数不正确，请检查后重试\"}");
  return;
}

// 正常生成Excel并输出的逻辑
response.setContentType("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet");
response.setHeader("Content-Disposition", "attachment; filename=导出数据.xlsx");
// 将Excel写入response.getOutputStream()

方案二：重定向回原页面带错误参数（适合简单场景） #

如果不想写复杂的AJAX逻辑，可以让Servlet在成功时返回下载响应，失败时重定向回发起请求的页面，并带上错误参数，前端页面加载时检测参数并提示用户。

后端Servlet逻辑： #

if (Excel生成成功) {
  // 正常设置下载响应头和输出流
  response.setContentType("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet");
  response.setHeader("Content-Disposition", "attachment; filename=导出数据.xlsx");
  // 写入Excel数据
} else {
  // 重定向回原页面，携带错误参数
  String errorMsg = URLEncoder.encode("数据为空，无法生成Excel", "UTF-8");
  response.sendRedirect(request.getContextPath() + "/your-page?error=download_failed&msg=" + errorMsg);
}

前端页面检测逻辑： #

window.addEventListener('load', () => {
  const urlParams = new URLSearchParams(window.location.search);
  const errorType = urlParams.get('error');
  
  if (errorType === 'download_failed') {
    const errorMsg = urlParams.get('msg') || '未知错误';
    alert(`下载失败：${errorMsg}`);
    // 移除URL中的错误参数，避免刷新页面再次提示
    window.history.replaceState({}, document.title, window.location.pathname);
  }
});

两种方案对比 #

你可以根据自己的业务场景选择合适的方案~

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