运行Maven项目遇X11窗口服务器连接错误，如何禁用该连接？

这个问题我之前在服务器环境部署JFreeChart相关项目时也碰到过，本质是JFreeChart默认需要图形环境支持，但Jenkins这类无桌面服务器没有可用的X11服务，所以抛出了Can't connect to X11 window server的错误。下面给你几个可行的解决办法：

方法1：运行Maven时添加无头模式参数 #

直接在Maven命令中指定JVM参数，强制Java使用无头模式，无需依赖图形界面：

mvn exec:java -Djava.awt.headless=true

如果是在Jenkins构建配置里，把这个参数加到Goals and options输入框即可，比如：

exec:java -Djava.awt.headless=true

方法2：在代码中提前启用无头模式 #

如果不想每次运行都手动加参数，可以在项目主类的开头（JFreeChart初始化逻辑之前）添加代码，全局设置无头模式：

public class Main {
    public static void main(String[] args) {
        // 先启用无头模式
        System.setProperty("java.awt.headless", "true");
        
        // 后续的JFreeChart初始化、PDF生成逻辑
        CreatePdf();
        // ...
    }
}

方法3：配置Maven插件自动带上参数 #

修改项目的pom.xml，给exec-maven-plugin添加系统属性配置，这样每次运行插件都会自动启用无头模式：

<plugin>
    <groupId>org.codehaus.mojo</groupId>
    <artifactId>exec-maven-plugin</artifactId>
    <version>1.4.0</version>
    <configuration>
        <mainClass>ReportPdfSend.Main</mainClass>
        <systemProperties>
            <systemProperty>
                <key>java.awt.headless</key>
                <value>true</value>
            </systemProperty>
        </systemProperties>
    </configuration>
</plugin>

原理说明 #

java.awt.headless=true是Java提供的无头模式开关，开启后Java会模拟图形环境的核心功能，但不需要依赖实际的X11窗口服务器，完全适配无桌面的服务器环境，JFreeChart可以正常生成图表而不会再触发X11连接错误。

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