使用OutputStream上传Excel文件时出现损坏问题求助

我之前也碰到过类似的Excel文件上传后损坏的棘手问题，结合你提供的代码片段和报错信息，咱们一步步来排查解决：

问题现象回顾 #

• 上传部分Excel文件后，文件损坏，直接用Excel打开会提示文件损坏
• 使用Aspose Workbook读取时，抛出结构化存储相关异常，比如：
  • java.lang.IllegalStateException: The FAT in the structured storage document seems to be corrupted.
  • java.lang.IllegalStateException: The structured storage seems to be corrupt.
• 即使改用file.transferTo(outputFile)方法，仍有部分文件出现上述异常

可能的原因分析 #

1. 流资源未正确释放：手动关闭流时，如果中途抛出异常，后续的close()方法可能不会执行，导致文件写入不完整
2. 文件传输/写入时的完整性问题：比如目标文件未被完全覆盖、网络传输丢包（如果是远程上传）
3. Aspose Cells版本兼容性：旧版本对某些Excel格式（如兼容模式的XLS、带宏的文件）的结构化存储处理存在bug
4. 上传配置问题：如果是Web上传，可能存在二进制文件被误处理为文本流的情况

具体解决方案 #

1. 用try-with-resources自动管理流资源 #

这是最常见的修复点，手动关闭流容易因为异常导致资源泄漏，改用JDK7+的try-with-resources可以自动关闭所有实现AutoCloseable的资源，确保文件完整写入：

try (InputStream stream = file.getInputStream();
     OutputStream os = new FileOutputStream("path_to_xlsFile.xls");
     BufferedOutputStream bos = new BufferedOutputStream(os)) {
    int bytesRead;
    byte[] buffer = new byte[8192];
    while ((bytesRead = stream.read(buffer, 0, 8192)) != -1) {
        bos.write(buffer, 0, bytesRead);
    }
    bos.flush();
} catch (IOException e) {
    // 这里添加日志记录或业务异常处理
    e.printStackTrace();
}

2. 优化transferTo方法的使用 #

如果使用transferTo，确保目标文件不存在（避免旧数据残留），并且有足够的写入权限：

File outputFile = new File("path_to_xlsFile.xls");
// 先删除已存在的目标文件，避免部分覆盖导致损坏
if (outputFile.exists() && !outputFile.delete()) {
    throw new IOException("无法删除已存在的目标文件");
}
file.transferTo(outputFile);

3. 升级Aspose Cells到最新稳定版 #

旧版本的Aspose Cells对结构化存储的处理存在不少bug，建议升级到最新的稳定版本，很多类似的损坏报错都在新版本中得到了修复。

4. 添加文件完整性校验 #

上传前后计算文件的MD5（或SHA-1）哈希值，对比是否一致，确认是传输过程损坏还是后续处理问题：

// 计算上传文件的MD5
String sourceMd5 = calculateMd5(file.getInputStream());
// 写入文件后再计算一次
String targetMd5 = calculateMd5(new FileInputStream("path_to_xlsFile.xls"));
if (!sourceMd5.equals(targetMd5)) {
    throw new RuntimeException("文件上传后完整性校验失败");
}

// 辅助计算MD5的方法
private String calculateMd5(InputStream inputStream) throws IOException {
    MessageDigest md = MessageDigest.getInstance("MD5");
    byte[] buffer = new byte[8192];
    int bytesRead;
    while ((bytesRead = inputStream.read(buffer)) != -1) {
        md.update(buffer, 0, bytesRead);
    }
    byte[] digest = md.digest();
    return DatatypeConverter.printHexBinary(digest).toLowerCase();
}

5. 确认上传配置的正确性 #

如果是Web环境下的上传，确保Multipart配置正确，禁止将二进制文件转换为文本流。比如在Spring MVC中，确保MultipartResolver的配置没有错误的编码设置，保持默认的二进制处理即可。

测试建议 #

• 先用一个新建的简单Excel文件（比如只有几行数据的XLS/XLSX）测试上传，确认基础流程是否正常
• 针对出现问题的特定文件，检查是否有特殊格式（如宏、图片、复杂公式），验证新版本Aspose是否支持

内容的提问来源于stack exchange，提问作者Jagriti Sethi