JAVA POI导出报错权限不足

记录一下今天遇到的一个 POI 导出 Excel 报错 权限不足 的问题

今天测试环境有人反映,说是报表导出的时候,导出来的报表一片空白,甚至于连表头都没有
我第一反映是,最近也没有动过代码呀,唯一有改动的就是切换了一下启动服务的账号
随即登上服务器看日志,错误信息如下:

java.lang.RuntimeException: java.io.IOException: 权限不够
    at org.apache.poi.xssf.streaming.SXSSFWorkbook.createAndRegisterSXSSFSheet(SXSSFWorkbook.java:662)
    at org.apache.poi.xssf.streaming.SXSSFWorkbook.createSheet(SXSSFWorkbook.java:679)
    at org.apache.poi.xssf.streaming.SXSSFWorkbook.createSheet(SXSSFWorkbook.java:90)
    at com.alibaba.excel.util.WorkBookUtil.createSheet(WorkBookUtil.java:51)
    at com.alibaba.excel.context.WriteContext.currentSheet(WriteContext.java:112)
    at com.alibaba.excel.write.ExcelBuilderImpl.addContent(ExcelBuilderImpl.java:69)
    at com.alibaba.excel.ExcelWriter.write(ExcelWriter.java:78)

从异常栈中可以定位到是 SXSSFWorkbook.java 662 行抛出的异常

找到 SXSSFWorkbook.java 的 662 行可以看到以下代码:

SXSSFSheet createAndRegisterSXSSFSheet(XSSFSheet xSheet) {
    final SXSSFSheet sxSheet;
    try {
        sxSheet = new SXSSFSheet(this,xSheet);
    } catch (IOException ioe) {
        throw new RuntimeException(ioe);//662行抛出异常的地方
    }
    registerSheetMapping(sxSheet,xSheet);
    return sxSheet;
}

从上面的代码中可以看出,是在执行 new SXSSFSheet(this,xSheet) 的时候出现了异常,然后异常被捕获,重新抛出了一个运行时异常。

具体是什么原因造成的异常就还需要再看看执行 new SXSSFSheet(this,xSheet) 的时候,SXSSFSheet 对应的构造函数干了啥,找到这个构造函数,代码如下:

public SXSSFSheet(SXSSFWorkbook workbook, XSSFSheet xSheet) throws IOException {
    _workbook = workbook;
    _sh = xSheet;
    _writer = workbook.createSheetDataWriter();
    setRandomAccessWindowSize(_workbook.getRandomAccessWindowSize());
    _autoSizeColumnTracker = new AutoSizeColumnTracker(this);
}

在上面的代码中,看到在 SXSSFSheet 的这个构造函数中执行了一些赋值的操作,经过一番查看,发现问题应该是出在 workbook.createSheetDataWriter() 这个调用里面。

再往下跟进去,会发现最终都会调用到 SheetDataWriter 这个类的无参构造方法,构造方法代码如下:

public SheetDataWriter() throws IOException {
    _fd = createTempFile();
    _out = createWriter(_fd);
}

据方法名不难看出,构造函数里面的操作应该是,创建临时文件,然后根据创建好的临时文件,再创建一个 Sheet 的 Writer。

跟到这里大概已经找到问题的原因了,应该就是当前启动服务的账号,没有临时文件目录的写入权限,具体的临时文件保存路径在哪里呢?

跟到 createTempFile 这个方法中便知道了,进入到 createTempFile 方法一路跟下去会看到 org.apache.poi.util.DefaultTempFileCreationStrategy#createPOIFilesDirectory 这个方法,代码如下:

private void createPOIFilesDirectory() throws IOException {
    // Identify and create our temp dir, if needed
    // The directory is not deleted, even if it was created by this TempFileCreationStrategy
    if (dir == null) {
        String tmpDir = System.getProperty(JAVA_IO_TMPDIR);
        if (tmpDir == null) {
            throw new IOException("Systems temporary directory not defined - set the -D" + JAVA_IO_TMPDIR + " jvm property!");
        }
        dir = new File(tmpDir, POIFILES);
    }
        
    createTempDirectory(dir);
}

方法中有两个常量 JAVA_IO_TMPDIRPOIFILES

两个常量的值分别为 java.io.tmpdirpoifiles

这个方法,就可以看出,临时文件的创建路径为:系统配置的 java.io.tmpdir 路径下的 poifiles 目录下。

如果没有手动设置过 java.io.tmpdir 的值的话,在 Linux 下获取到这个配置的默认的路径应该是 /tmp 目录。

那么,临时文件的创建路径为 /tmp/poifiles。这时再去看下这个临时文件目录的权限,果然当前启动服务的账号没有写入权限,所以导出的时候报了权限不足的异常。

解决这个最粗暴的方式,直接使用 chmod -R 777 /tmp/poifiles 将临时文件目录权限设为 777,或者是在服务启动的时候设置临时文件的路径为当前启动服务的账号有权限写入的路径,可以使用 System.setProperty(java.io.tmpdir, "xxxx") 来设置,也可以在启动时加 -Djava.io.tmpdir=xxxx来设置。

推荐阅读更多精彩内容

  • 一:java概述:1,JDK:Java Development Kit,java的开发和运行环境,java的开发工...
    ZaneInTheSun阅读 2,313评论 0 11
  • 1.import static是Java 5增加的功能,就是将Import类中的静态方法,可以作为本类的静态方法来...
    XLsn0w阅读 974评论 0 2
  • 第01章 JAVA简介第02章 基础语法第02章 递归补充第03章 面向对象第04章 异常处理第05章 数组第06...
    顺毛阅读 343评论 0 1
  • 今天是3月22日世界水日中国水周,主题为河长。同时也标志着我在水利行业工作了整整七年。有人说七年就是一辈子,在七年...
    妮秋儿阅读 208评论 0 0
  • 眉亦轻佻,折扇摇摇,一袭白衣,乌发高束。 贰月楼,琴声潇潇,歌舞升平。过往的人儿,笑脸娇媚,月娘喜盈盈的到门前迎接...
    绿小怪阅读 138评论 0 1
  • 第二天清晨,朝汐来到归云苑告诉玉子初尊主找她。玉子初收拾了会就跟着朝汐一起朝紫宸阁走去。 朝汐看着玉子初不着粉黛,...
    木半鱼阅读 57评论 0 0
  • 如果肌肤不干净,使用再多的护肤品、面膜都难以吸收进去,所以说要想让肌肤喝饱水,首先需要解决的是让毛孔打开,使里面的...
    死穴443阅读 167评论 0 0