使用JavaFX WebEngine.print()触发IllegalStateException问题

你遇到的这个问题确实挺闹心——每次打印WebView加载的HTML文档，都会精准抛出7次IllegalStateException，虽然打印功能能正常完成，但这些异常日志看着实在头疼。先帮你拆解下问题根源，再给出针对性的解决方案：

问题根源分析 #

从你提供的异常栈信息来看，异常来自RenderThemeImpl.ensureNotDefault()方法，这个方法的作用是校验WebKit使用的渲染主题不是默认主题。在打印流程中，WebKit会尝试为HTML里的控件（比如按钮、输入框这类依赖系统主题渲染的元素）创建渲染组件，但此时的执行上下文不符合方法的预期，导致每个需要主题渲染的元素都会触发一次异常。你看到的7次异常，大概率是因为你的HTML文档里恰好包含7个这类元素。

你尝试过切换线程（FX线程、独立线程、监听器）都没解决，是因为这个问题的核心不是线程归属，而是打印触发时机和WebKit内部渲染主题的上下文冲突。

可行解决方案 #

1. 确保HTML完全加载后再触发打印 #

WebEngine的print()方法如果在HTML还没完全加载完成时调用，很容易导致内部状态异常。你可以监听WebEngine的stateProperty()，确认页面加载完成后再响应打印请求：

@FXML 
public void initialize() { 
    engine = webviewer.getEngine(); 

    // 先监听页面加载完成状态
    engine.stateProperty().addListener((obs, oldState, newState) -> {
        if (newState == Worker.State.SUCCEEDED) {
            // 页面加载完成后，再注册打印请求监听器
            printReq.addListener(new ChangeListener<Boolean>() { 
                @Override 
                public void changed(ObservableValue<? extends Boolean> observable, Boolean oldValue, Boolean newValue) { 
                    if (newValue && Security.okayToPrint()) { 
                        PrinterJob job = PrinterJob.createPrinterJob(Printer.getDefaultPrinter()); 
                        if (job != null) { 
                            if (job.showPrintDialog(Info.windowHandle)) { 
                                Squirt.out(5, "PostView - User wants to print a page!!!!");
                                // 用Platform.runLater确保在FX线程的正确上下文执行
                                Platform.runLater(() -> {
                                    try {
                                        engine.print(job); 
                                        job.endJob(); 
                                    } catch (IllegalStateException e) {
                                        // 捕获预期内的主题异常，避免日志刷屏
                                        Squirt.out(3, "打印主题警告（可忽略）: " + e.getMessage());
                                    }
                                });
                            } 
                        } else { 
                            Log.warning("Could not create a print job"); 
                            final Shout shout = new Shout(AlertType.ERROR); 
                            shout.setContentText(Info.lexicon.shipLogPrintErrorMsg); 
                            shout.showAndWait(); 
                        } 
                    } 
                    printReq.set(false); 
                } 
            });
        }
    });
}

2. 显式设置WebView的用户样式表 #

通过设置自定义样式表，强制WebKit切换到非默认渲染主题，绕过ensureNotDefault()的检查逻辑：

@FXML 
public void initialize() { 
    engine = webviewer.getEngine(); 
    // 设置自定义样式表（可以是空文件，目的是切换主题上下文）
    engine.setUserStyleSheetLocation(getClass().getResource("print-override.css").toExternalForm());

    // 后续的打印请求监听逻辑...
}

你可以创建一个空的print-override.css文件放在资源目录下，只要WebEngine加载了自定义样式表，就会脱离默认主题的上下文约束。

3. 捕获异常并过滤（临时妥协方案） #

如果上面的方法都无法彻底消除异常，你可以选择性捕获这个特定异常——因为打印功能本身是正常的，只是日志刷屏：

// 在调用engine.print()的位置包裹try-catch
try {
    engine.print(job);
} catch (IllegalStateException e) {
    // 只过滤预期内的主题异常，其他异常正常抛出
    if (!e.getMessage().contains("the method should not be called in this context")) {
        throw e;
    } else {
        Squirt.out(3, "忽略打印主题警告（不影响功能）");
    }
}
job.endJob();

为什么之前的线程调整没用？ #

这个异常不是线程错误导致的，而是WebKit在打印渲染控件时，内部主题初始化的上下文不符合RenderThemeImpl的预期。从栈信息里的enterNestedEventLoop可以看到，打印流程会启动嵌套事件循环，这会导致主题检查的上下文发生变化，从而抛出异常——哪怕你已经在FX线程中执行，这种嵌套循环的上下文也会触发问题。

内容的提问来源于stack exchange，提问作者TR. Martin