使用Apache POI 4生成的Excel柱状图在Microsoft 365中显示文件损坏

核心原因 #

Apache POI 4发布于2019年，其图表生成逻辑未适配Office 365后续更新的严格格式校验规则，导致生成的XLSX文件被新版本Office判定为损坏。

具体解决办法 #

• 升级Apache POI版本
  直接升级到最新稳定版（如5.2.5及以上），新版本修复了大量与Office 365的兼容问题。以Maven依赖为例，更新配置：

  <dependency>
      <groupId>org.apache.poi</groupId>
      <artifactId>poi</artifactId>
      <version>5.2.5</version>
  </dependency>
  <dependency>
      <groupId>org.apache.poi</groupId>
      <artifactId>poi-ooxml</artifactId>
      <version>5.2.5</version>
  </dependency>
  

• 检查图表创建代码细节

  • 确保数据源引用未超出工作表有效单元格范围，避免无效单元格引用触发Office 365的格式校验报错
  • 移除代码中使用的过时图表样式或属性（如部分旧版自定义填充、边框格式），改用Office 365兼容的标准样式API
  • 验证XSSFChart与工作表的关联逻辑，确保系列数据、绘图区等部件正确绑定，无缺失

• 验证生成文件的完整性
  使用POI自带工具检查文件格式合法性，快速定位问题：

  try (OPCPackage pkg = OPCPackage.open("target-file.xlsx", PackageAccess.READ)) {
      if (pkg.verify()) {
          System.out.println("文件格式合法");
      } else {
          System.out.println("文件存在格式异常");
      }
  } catch (Exception e) {
      e.printStackTrace();
  }
  

• POI 4环境下的临时修复
  如果无法升级版本，可尝试：

  • 打开损坏文件时选择Office 365的"修复"选项，根据修复日志定位具体损坏的图表部件，针对性调整代码
  • 避免使用POI 4中已知存在兼容问题的图表API（如部分自定义标签、坐标轴样式方法），改用最基础的柱状图生成逻辑

内容的提问来源于stack exchange，提问作者Abdul Hameed M