使用PrinterJob打印JavaFX Node时虚拟打印机输出乱码问题排查

咱们来拆解下你遇到的这个问题——在macOS High Sierra上用JavaFX的PrinterJob打印Node到虚拟打印机时出现乱码，两款虚拟打印机都出现异常：本该输出预期内容，结果只生成了有问题的PDF。我之前碰到过类似场景，给你梳理下可能的原因和解决方向：

1. 先排查代码层面的潜在问题 #

你提供的代码片段不完整，但从已有的部分来看，有个很容易忽略的关键点：打印任务的收尾处理缺失。

你现在只调用了job.printPage(node)，但打印完成后必须调用endJob()来完成任务、释放系统打印资源，否则虚拟打印机可能无法正确生成完整的PDF内容，表现为乱码或空白。补全后的代码应该是这样：

private void print(Node node, Stage owner) {
    System.out.println("Creating a printer job...");
    PrinterJob job = PrinterJob.createPrinterJob();
    if (job != null) {
        // 先确保Node完成布局渲染
        node.applyCss();
        node.layout();
        
        boolean success = job.printPage(node);
        if (success) {
            // 必须调用此方法完成打印任务
            boolean jobFinished = job.endJob();
            if (!jobFinished) {
                System.err.println("打印任务完成失败");
            }
        } else {
            System.err.println("打印页面失败");
        }
    } else {
        System.err.println("无法创建打印机任务");
    }
}

另外还要注意：如果你的Node还没被添加到Scene或者还没完成布局计算，打印出来的内容必然异常。代码里加的applyCss()和layout()就是强制Node完成渲染布局，这对未显示在界面上的Node尤其重要。

2. macOS虚拟打印机的兼容性Bug #

macOS High Sierra上的虚拟打印机（比如系统自带的PDF打印机）和JavaFX的打印API存在一些已知的兼容性问题，尤其是在使用Java 8自带的JavaFX版本时：

• JavaFX的PrinterJob在macOS上依赖系统打印框架，部分虚拟打印机可能无法正确解析JavaFX传递的矢量渲染数据，转成PDF时就会出现乱码。
• 你可以先找一台物理打印机测试，如果物理打印机能正常输出预期内容，那基本可以确定是虚拟打印机和JavaFX的兼容性Bug。

3. JavaFX版本的影响 #

如果你用的是Java 8自带的JavaFX，High Sierra上确实存在不少打印相关的旧Bug。建议升级到JavaFX 11及以上的OpenJFX版本，新版本对macOS的打印支持做了大量修复，能解决很多类似的异常问题。

快速排查步骤 #

1. 先补全代码中的endJob()调用，加上applyCss()和layout()，重新测试；
2. 用物理打印机打印测试，对比输出结果；
3. 尝试升级JavaFX到最新稳定版。

如果以上步骤都解决不了问题，那大概率是JavaFX在macOS High Sierra上与虚拟打印机的兼容性Bug，你可以向OpenJFX官方提交问题反馈。

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