Linux部署JFreeChart图片生成Java应用遇No X11 Display异常求助

方法一：确保Headless模式正确生效（最推荐） #

你的应用只需要生成图片无需GUI，必须让java.awt.headless=true真正生效，试试这几种设置方式：

• 启动JVM时直接加参数：java -Djava.awt.headless=true -jar your-app.jar
• 在代码最开头（JFreeChart初始化前）设置系统属性：

  public static void main(String[] args) {
      System.setProperty("java.awt.headless", "true");
      // 后续JFreeChart相关代码
  }
  

• 用脚本启动的话，先配置环境变量：export JAVA_OPTS="-Djava.awt.headless=true"，再启动应用

方法二：用虚拟X服务器（Xvfb）模拟显示环境 #

如果Headless模式还是不行，就装个虚拟X环境替代真实显示器：

1. 安装Xvfb（Debian/Ubuntu为例）：sudo apt-get install xvfb
2. 启动虚拟显示后台进程：Xvfb :1 -screen 0 1024x768x16 &
3. 把DISPLAY指向虚拟环境：export DISPLAY=:1
4. 正常启动你的Java应用：java -jar your-app.jar
   可以把这些命令写到启动脚本里，避免每次手动操作。

方法三：检查JFreeChart代码逻辑 #

确认代码里没有调用任何GUI相关的方法，比如ChartFrame这类窗口显示类，只保留纯图片生成逻辑：

// 创建图表实例
JFreeChart chart = ChartFactory.createPieChart("示例图表", dataset, true, true, false);
// 直接输出为图片文件
try {
    ChartUtilities.saveChartAsPNG(new File("output.png"), chart, 800, 600);
} catch (IOException e) {
    e.printStackTrace();
}

方法四：补全系统AWT依赖库 #

部分Linux发行版可能缺少JDK运行AWT需要的底层库，安装对应包：

• Debian/Ubuntu：sudo apt-get install libxrender1 libxtst6 libxi6
• CentOS/RHEL：sudo yum install libXrender libXtst libXi

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