EasyExcel导出异常分析与解决方案：Can not close IO问题排查

问题现象

在使用EasyExcel 3.1.1版本配合POI 4.1.2版本进行Excel导出操作时，开发者遇到了"Can not close IO"的异常。该问题发生在调用excelWriter.finish()方法时，导致导出流程中断。

异常分析

从异常堆栈中可以发现，根本原因是POI库抛出的InvalidOperationException，具体错误信息表明存在重复的文档属性部分：

A part with the name '/docProps/core.xml' already exists : Packages shall not contain equivalent part names...

这种错误通常发生在以下情况：

1. 多线程环境下同时操作同一个Excel文件
2. Excel模板文件本身存在结构性问题
3. 依赖库版本不兼容导致文件处理异常

技术背景

EasyExcel底层依赖于Apache POI库处理Excel文件。在POI 4.x版本中，对OOXML文件格式的处理机制有所调整。当处理包含多个相同名称部分的文档时，POI会严格校验并抛出异常，这与早期版本的宽松处理方式不同。

解决方案

方案一：升级依赖版本

根据开发者反馈，将POI升级到5.2.5版本，EasyExcel升级到3.3.4版本后问题得到解决。这是因为：

1. 新版本POI改进了文件处理机制
2. EasyExcel新版本优化了与POI的兼容性
3. 版本升级可以规避已知的bug

方案二：检查模板文件

1. 确保模板文件结构完整且没有损坏
2. 验证模板中不包含重复的命名部分
3. 尝试使用其他模板文件进行测试

方案三：代码优化

1. 确保单线程操作Excel文件
2. 为每个写入操作使用唯一的sheet名称
3. 显式关闭所有IO资源

// 示例代码优化
try (InputStream is = ...;
     OutputStream os = ...) {
    ExcelWriter writer = EasyExcel.write(os)
        .withTemplate(is)
        .build();
    try {
        // 写入操作...
    } finally {
        if (writer != null) {
            writer.finish();
        }
    }
}

最佳实践建议

1. 版本一致性：保持EasyExcel和POI版本的匹配，参考官方文档推荐的组合
2. 资源管理：使用try-with-resources确保资源正确释放
3. 模板验证：对模板文件进行预处理检查
4. 异常处理：添加适当的异常捕获和处理逻辑
5. 日志记录：在关键操作点添加日志，便于问题排查

总结

"Can not close IO"异常通常反映了底层文件处理的问题。通过升级依赖版本、优化代码结构、验证模板文件完整性等措施，可以有效解决这类问题。对于使用EasyExcel的开发者来说，保持依赖库版本的兼容性尤为重要，同时也要注意资源管理和异常处理的完善。