EasyExcel 导出文件过大报错分析

共计 1795 个字符，预计需要花费 5 分钟才能阅读完成。

用 EasyExcel 导出带图片的 Excel 时，如果图片较少，可以正常导出。当图片较多时，后台报错如下。

Request processing failed; nested exception is java.lang.IllegalStateException: UT000002: The response has already been started

而导出的代码是官方示例代码进行修改的：

    /**
     * 文件下载并且失败的时候返回json（默认失败了会返回一个有部分数据的Excel）
     *
     * @since 2.1.1
     */
    @GetMapping("downloadFailedUsingJson")
    public void downloadFailedUsingJson(HttpServletResponse response) throws IOException {
        // 这里注意 有同学反应使用swagger 会导致各种问题，请直接用浏览器或者用postman
        try {
            response.setContentType("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet");
            response.setCharacterEncoding("utf-8");
            // 这里URLEncoder.encode可以防止中文乱码 当然和easyexcel没有关系
            String fileName = URLEncoder.encode("测试", "UTF-8").replaceAll("\\+", "%20");
            response.setHeader("Content-disposition", "attachment;filename*=utf-8''" + fileName + ".xlsx");
            // 这里需要设置不关闭流
            EasyExcel.write(response.getOutputStream(), DownloadData.class).autoCloseStream(Boolean.FALSE).sheet("模板")
                .doWrite(data());
        } catch (Exception e) {
            // 重置response
            response.reset();
            response.setContentType("application/json");
            response.setCharacterEncoding("utf-8");
            Map<String, String> map = MapUtils.newHashMap();
            map.put("status", "failure");
            map.put("message", "下载文件失败" + e.getMessage());
            response.getWriter().println(JSON.toJSONString(map));
        }
    }

起初以为是连续发起机器导出请求导致上一次的请求还没完，下一次的请求想去修改上一次请求的 response，但是我这猪脑子又一想，这玩意不是每次请求都会生成吗，又不是单实例的。

后来看见报错语句定位在 response.reset() 这一行，但其实还是有点摸不着头脑，为什么会报这个错，于是将 Exception 打印，发现异常是 Can not close IO 和 java.lang.OutOfMemoryError: Java heap space。

所以我的理解是，因为 OOM 导致输出流被关闭，但是 catch 代码块还想尝试去重置输出流，既然流都已经异常关闭了，再去重置输出流肯定就报错了。

此时来看，不能正常导出的原因就是因为 OOM，那么就试试简单粗暴的方法，增加 JVM 的堆内存空间！好消息是，果然可以正常导出了。坏消息是，通过 postman 可以正常导出，但是通过前端页面点击导出则不行，并且和之前报一样的错误！

直接调用接口和前端调用其实区别都不大，唯一有区别的就是前端设置了超时时间，所以猜测是前端设置的超时时间过短，然后生成 Excel 时间又需要很久，导致前端以为超时直接关闭了连接，等到程序想返回时发现连接已关闭，catch 到报错后又想去重置输出流，然而流已经关闭了。

总而言之，在这个案例中，出现这个报错的情况有两个：

• 后端异常，导致流已经关闭

• 前端请求超时，提前关闭连接

当然，这里的后端异常并不仅仅包括 OOM，还有可能是尝试多次关闭输出流导致的。

提醒：本文发布于291天前，文中所关联的信息可能已发生改变，请知悉！