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

【问题标题】：How to avoid HeadlessException when running TestFX on Jenkins?在 Jenkins 上运行 TestFX 时如何避免 HeadlessException？
【发布时间】：2021-06-15 21:10:13
【问题描述】：

我正在编写一个 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（显示器、键盘、鼠标）但我的代理确实有 GUI 时会发生 HeadlessException。此测试在 Windows 代理上正常工作，但在 MacOS 上不正常。如何避免此错误并在 Jenkins 上执行自动化测试？

【问题讨论】：

将参数 java.awt.headless=true 传递给 Gradle 可能会有所帮助。当作业尝试任何交互模式时，Jenkins 会返回一个异常。否则，如果可行，这个问题建议编程solutions。

标签： java jenkins gradle testfx

【解决方案1】：

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

【讨论】：