AWS Linux服务器使用sun.awt.X11GraphicsEnvironment报错求助

方案1：使用虚拟X11服务器（Xvfb）模拟显示环境 #

这是无头Linux环境下运行GUI相关Java程序的标准解决方案，步骤如下：

• 安装Xvfb及依赖组件：
  针对RHEL/CentOS系AWS AMI：

  sudo yum install -y xorg-x11-server-Xvfb xorg-x11-xauth xorg-x11-fonts-*
  

  针对Debian/Ubuntu系AWS AMI：

  sudo apt-get update && sudo apt-get install -y xvfb xauth xfonts-base
  

• 启动虚拟显示会话：

  Xvfb :1 -screen 0 1920x1080x24 &
  

  其中:1为显示编号，1920x1080x24是分辨率和色深，可按需调整。
• 设置DISPLAY环境变量，让Java程序指向虚拟显示：

  export DISPLAY=:1
  

• 运行Java程序，明确关闭headless模式：

  java -Djava.awt.headless=false -jar your-screenshot-app.jar
  

  或在代码中确保System.setProperty("java.awt.headless", "false");在初始化AWT组件前执行。

方案2：替换为无需AWT的截图方案 #

如果Xvfb方案仍有问题，可绕过java.awt.Robot，直接调用系统截图工具：

• 安装系统截图工具（以scrot为例）：
  RHEL/CentOS：sudo yum install -y scrot
  Debian/Ubuntu：sudo apt-get install -y scrot
• 在Java代码中通过ProcessBuilder调用scrot命令：

  ProcessBuilder pb = new ProcessBuilder("scrot", "/tmp/screenshot.png");
  pb.inheritIO();
  Process process = pb.start();
  process.waitFor();
  // 后续读取/tmp/screenshot.png文件即可
  

  运行前需先执行方案1中的Xvfb启动和DISPLAY设置。

方案3：确保Java环境包含完整的AWT/X11支持 #

部分AWS AMI默认安装的是headless版本的OpenJDK，缺少X11相关依赖：

• 卸载headless版本的Java：

  sudo yum remove java-*-openjdk-headless
  

• 安装完整的OpenJDK开发包：

  sudo yum install java-11-openjdk-devel
  

  版本可根据需求替换为8/17等。
• 验证Java是否包含X11支持：

  java -version
  java -Djava.awt.headless=false -XshowSettings:properties | grep awt
  

  输出应包含java.awt.headless = false及X11相关属性。

额外排查点 #

• 检查LD_LIBRARY_PATH是否包含X11库路径：

  export LD_LIBRARY_PATH=/usr/lib64/X11:$LD_LIBRARY_PATH
  

  32位系统路径为/usr/lib/X11。
• 确保运行Java程序的用户有权限访问Xvfb会话，可通过xauth配置：

  xauth add :1 . $(mcookie)
  

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