Wicket 8应用中使用JODConverter实现Excel转PDF无报错但转换失效

• 老旧版本JODConverter的静默兜底逻辑缺陷
  目前使用的2.2.1、3.0-beta-4均为停止维护多年的版本，这类版本内置的异常处理逻辑存在明显缺陷：一旦遇到Office进程连接失败、格式匹配失败等场景，不会向外抛出任何错误，反而会直接将源文件内容原样拷贝到目标输出路径。这就是为什么用户下载到的文件还是Excel原始内容，控制台却没有任何报错的核心原因。
• 临时文件未写入完成就启动转换流程
  代码中向FileOutputStream写入Excel内容后，没有执行flush、关闭流的操作，数据还停留在JVM的输出缓冲区中，磁盘上的临时Excel文件并未写入完整内容。转换器读取到不完整的源文件时，同样会触发上述静默兜底逻辑，直接把已读取到的部分内容拷贝到PDF结果文件中。
• 格式映射未显式声明
  老版本的OfficeDocumentConverter需要依赖显式的格式注册表才能识别“Excel输入、PDF输出”的转换流程，代码中初始化转换器时没有传入格式注册表，转换器无法匹配正确的PDF导出过滤器，只能触发无转换的文件拷贝逻辑。
• 异常处理逻辑吞错
  catch块仅打印堆栈日志，没有将异常向上传递，也没有对转换结果做有效性校验，哪怕整个转换流程从一开始就连接失败，方法依然会返回被拷贝内容的结果文件，前端无感知直接提供下载。

• 替换已停止维护的老旧依赖，选用持续更新的JODConverter稳定版本，移除beta版的不稳定逻辑。
• 调整OfficeManager的初始化方式，改为应用全局单例实例，在应用启动时完成与LibreOffice进程的连接初始化，应用关闭时统一销毁连接，不要在每次转换时重复新建连接、触发启动流程。
• 修复临时文件写入逻辑，使用try-with-resources自动管理输出流，确保Excel内容完全刷入磁盘、流关闭后再启动转换流程。
• 初始化OfficeDocumentConverter时显式传入默认格式注册表，明确声明输入输出的格式映射规则，让转换器正确调用PDF导出过滤器，跳过无转换的兜底逻辑。
• 优化异常处理逻辑，捕获异常时直接将结果文件置空并向外抛出业务异常，不要把内容错误的文件返回给前端。
• 增加结果有效性校验，转换完成后读取PDF文件的文件头，确认是否以标准%PDF-标识开头，不符合标识的文件直接判定为转换失败。

修正后的核心代码示例 #

public File convertToPDFFile(ByteArrayOutputStream fromExcelFile, String sheetName, OOConfig ooConfig, FileFormat fileFormat) throws Exception {
    // 全局单例的OfficeManager实例，实际在应用启动阶段完成初始化
    File tempFile = null;
    File resultPDFFile = null;
    try {
        // 写入临时Excel文件，自动关闭流、刷入磁盘
        tempFile = File.createTempFile(sheetName, fileFormat.getFileExtension());
        try (FileOutputStream fout = new FileOutputStream(tempFile)) {
            fromExcelFile.writeTo(fout);
            fout.flush();
        }
        // 校验临时文件非空，避免读取无效源文件
        if (tempFile.length() <= 0) {
            throw new IllegalStateException("临时Excel文件写入为空，无法启动转换");
        }

        // 初始化转换器时显式传入格式注册表
        OfficeDocumentConverter officeDocConverter = new OfficeDocumentConverter(
            globalSingletonOfficeManager, 
            new DefaultDocumentFormatRegistry()
        );
        
        // 生成结果文件并执行转换
        resultPDFFile = File.createTempFile(sheetName, TypeOfFile.PDF.getFileExtension());
        officeDocConverter.convert(tempFile, resultPDFFile);

        // 校验结果为有效PDF文件
        try (FileInputStream fis = new FileInputStream(resultPDFFile)) {
            byte[] header = new byte[5];
            fis.read(header);
            if (!new String(header).startsWith("%PDF-")) {
                throw new IllegalStateException("转换结果不是有效PDF文件");
            }
        }
    } catch (Exception e) {
        // 异常直接向上抛出，不吞错
        throw e;
    } finally {
        // 清理临时源文件
        if (tempFile != null && tempFile.exists()) {
            tempFile.delete();
        }
        // 清理无效的结果文件
        if (resultPDFFile != null && (!resultPDFFile.exists() || resultPDFFile.length() <= 0)) {
            resultPDFFile.delete();
        }
    }
    return resultPDFFile;
}

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