在 Jenkins 上运行 TestFX 时如何避免 HeadlessException？

问题描述

我正在编写一个 TestFX 测试用例来覆盖 Java 桌面应用程序。其中一个交互调用 showDocument() 以使用浏览器显示 html 文档。使用 Gradle 在本地运行测试时，我的测试工作正常。但是当我在 Jenkins 上运行它（使用 MacOS 代理）时，测试失败了。

14:55:10     java.awt.HeadlessException
14:55:10        at java.desktop/java.awt.Desktop.getDesktop(Desktop.java:301)
14:55:10        at javafx.graphics/com.sun.javafx.application.HostServicesDelegate$StandaloneHostService.showDocument(HostServicesDelegate.java:133)
14:55:10        at javafx.graphics/javafx.application.HostServices.showDocument(HostServices.java:115)

问题是在 Desktop 检查 GraphicsEnvironment.isHeadless() 时引起的

为什么会发生这个错误？我读到当没有可使用的 GUI（显示、键盘、鼠标）时会发生 HeadlessException，但我的代理确实有一个 GUI。此测试在 Windows 代理上正常工作，但在 MacOS 上不工作。如何避免此错误并在 Jenkins 上执行自动化测试？

解决方法

解决方案是更改 Jenkins 上的节点启动方法。他们使用 SSH 连接并将其更改为连接到 master 解决了问题（ssh 不通过 GUI 并直接将其连接到 master）。