多实例Wildfly生成XLSX时遇Permission denied权限异常求助

这个权限拒绝异常是Apache POI的SXSSFWorkbook在创建临时文件时的资源竞争或权限配置问题：

• SXSSF默认会在系统临时目录（如/tmp）生成临时文件处理大数据量的Excel流
• 同一服务器上的多个Wildfly实例共享同一临时目录时，会出现文件锁竞争或权限冲突，只有第一个抢占到资源的实例能正常运行

1. 为每个Wildfly实例配置专属临时目录 #

修改每个实例的standalone.xml（或domain.xml），添加实例独有的临时目录配置，彻底隔离跨实例资源竞争：

<system-properties>
    <!-- 替换为每个实例独有的路径，比如/opt/wildfly-instance1/temp -->
    <property name="jboss.server.temp.dir" value="/path/to/unique-instance-temp"/>
</system-properties>

配置后重启实例，确保Wildfly运行用户对该目录拥有**读写执行（rwx）**权限。

2. 手动指定SXSSF的临时文件存储目录 #

在代码中创建SXSSFWorkbook时，显式指定专属临时目录，避免实例间的临时文件冲突：

// 获取Wildfly实例的专属临时目录
String instanceTempDir = System.getProperty("jboss.server.temp.dir");
File sxssfTempDir = new File(instanceTempDir, "sxssf-excel-temp");
// 确保目录存在，无则创建
if (!sxssfTempDir.exists()) {
    sxssfTempDir.mkdirs();
}

// 使用带临时目录参数的SXSSFWorkbook构造函数
SXSSFWorkbook workbook = new SXSSFWorkbook(new XSSFWorkbook(), 100, true, true, sxssfTempDir);

参数说明：

• 100：内存中保留的行数，超出后写入临时文件
• 两个true：分别表示压缩临时文件、通过GC钩子自动删除临时文件

3. 确保正确关闭SXSSFWorkbook #

使用try-with-resources语法自动关闭工作簿，避免临时文件堆积引发的权限问题：

try (SXSSFWorkbook workbook = new SXSSFWorkbook(...)) {
    // 执行Excel生成逻辑：创建Sheet、填充数据等
    // ...
    
    // 将工作簿写入响应流
    response.setContentType("application/vnd.ms-excel");
    response.setHeader("Content-Disposition", "attachment; filename=report.xlsx");
    workbook.write(response.getOutputStream());
} catch (IOException e) {
    // 异常处理逻辑
    throw new RuntimeException("生成Excel失败", e);
}

4. 验证Apache POI版本兼容性 #

确保使用的POI版本与Java 1.8、Wildfly 24兼容：

• Java 1.8最高兼容POI 5.2.3
• 避免使用存在临时文件竞争bug的旧版本（如POI 3.x的部分版本）

1. 重启所有Wildfly实例
2. 分别测试每个实例的Excel生成接口
3. 检查每个实例的专属临时目录，确认临时文件会在工作簿关闭后自动删除

内容的提问来源于stack exchange，提问作者José Candia