升级Apache POI至4.1.2/5.x后Xlsx文件传第三方时损坏求助

针对你遇到的POI升级后Excel本地正常但第三方系统提示损坏的问题，结合Bugzilla 67396工单及常见排查方向，给出以下实用建议：

• 修复XML standalone属性问题
  Bugzilla 67396明确记录了POI 4.x/5.x版本生成的OOXML文件中，部分XML部件带有standalone="no"声明，导致Exchange Server、Power BI等严格遵循规范的系统解析失败。你可以通过以下方式强制移除该属性：

  // 方式1：通过工作簿属性配置
  XSSFWorkbook workbook = new XSSFWorkbook();
  POIXMLProperties xmlProps = workbook.getProperties();
  xmlProps.getCoreProperties().getUnderlyingProperties().setStandalone(null);
  

  若上述方式无效，可直接操作底层包部件修改XML声明（需谨慎处理，避免破坏结构）：

  OPCPackage pkg = workbook.getPackage();
  for (PackagePart part : pkg.getParts()) {
      if (part.getContentType().equals(XSSFRelation.WORKBOOK.getContentType())) {
          // 先读取原有内容，过滤掉带standalone的声明
          InputStream in = part.getInputStream();
          String content = new String(in.readAllBytes(), StandardCharsets.UTF_8)
              .replaceFirst("\\<\\?xml version=\"1\\.0\" encoding=\"UTF-8\" standalone=\"no\"\\?>", 
                           "<?xml version=\"1.0\" encoding=\"UTF-8\"?>");
          in.close();
          // 重新写入修改后的内容
          OutputStream out = part.getOutputStream();
          out.write(content.getBytes(StandardCharsets.UTF_8));
          out.close();
      }
  }
  

• 规范输出流处理流程
  即使调用了close()，仍需确保输出流的刷新顺序正确，避免数据写入不完整：

  workbook.write(outputStream);
  outputStream.flush(); // 强制刷新缓冲区，确保所有数据写入流
  workbook.dispose(); // 释放POI资源
  outputStream.close();
  

  若使用ByteArrayOutputStream，需在获取字节数组前完成所有刷新和资源释放操作。

• 验证文件OOXML合规性
  使用微软Open XML SDK的验证工具检查生成文件的合规性，定位是否存在其他结构错误：

  1. 初始化OpenXmlValidator实例
  2. 加载目标Excel文件，执行验证
  3. 根据输出的错误信息修复对应部件（如[Content_Types].xml的类型映射错误）

• 升级/降级POI版本
  Bugzilla 67396在POI 5.2.4版本已正式修复，建议直接升级到最新稳定版（如5.2.5）；若无法升级，可临时降级至POI 4.1.1版本（该版本未引入此standalone属性问题）

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