jenkins Linux下java.awt.HeadlessException的解决

最新推荐文章于 2024-12-01 22:56:18 发布

原创最新推荐文章于 2024-12-01 22:56:18 发布 · 851 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#运维 #java #操作系统

在Ubuntu服务器上部署的Java Web项目使用JFreeChart生成图片时遇到java.awt.HeadlessException。通过修改Tomcat的catalina.sh设置-Djava.awt.headless=true并未解决问题，因为需要Xserver支持。安装xserver-xorg并配置DISPLAY环境变量后，问题仍未解决。最终在论坛中找到答案，取消-Djava.awt.headless=true设置，问题得到解决。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

最近做的一个Java Web项目采用Struts2+Spring+HibernateJPA的标准架构，开发环境是win7，服务器部署环境是Ubuntu12.04，项目中有一个模块是采用JFreeChart生成图片，再创建并导入pdf文件中，开发完成后在windows下的tomcat6.0跑没有任何问题，但是部署到Ubuntu服务器上的tomcat6.0之后就不断出现问题。

最开始部署到Ubuntu服务器上的tomcat时，当要创建含图表的pdf文件时，报出如下异常：

java.awt.HeadlessException:
No X11 DISPLAY variable was set, but this program performed an operation which requires it.
        at java.awt.GraphicsEnvironment.checkHeadless(GraphicsEnvironment.java:159)
        at java.awt.Window.(Window.java:406)
        at java.awt.Frame.(Frame.java:402)
        at java.awt.Frame.(Frame.java:367)
        at javax.swing.JFrame.(JFrame.java:163)

上网查了一下，都说是没有配置Headless Mode。Headless模式是系统的一种配置模式。在该模式下，系统缺少了显示设备、键盘或鼠标。Headless模式虽然不是我们愿意见到的，但事实上我们却常常需要在该模式下工作，尤其是服务器端程序开发者。因为服务器（如提供Web服务的主机）往往可能缺少前述设备，但又需要使用他们提供的功能，生成相应的数据，以提供给客户端（如浏览器所在的配有相关的显示设备、键盘和鼠标的主机）。

因此修改${TOMCAT_HOME}/bin/catalina.sh或${TOMCAT_HOME}/bin/catalina.bat文件：

在所有类似以下代码：
    "$_RUNJAVA" $JAVA_OPTS $CATALINA_OPTS \
      -Djava.endorsed.dirs="$JAVA_ENDORSED_DIRS" -classpath "$CLASSPATH" \
      -Djava.security.manager \
      -Djava.security.policy=="$CATALINA_BASE"/conf/catalina.policy \
      -Dcatalina.base="$CATALINA_BASE" \
      -Dcatalina.home="$CATALINA_HOME" \
      -Djava.io.tmpdir="$CATALINA_TMPDIR" \

在尾部加上一句：
-Djava.awt.headless=true \

修改后内容如下：
    exec "$_RUNJAVA" $JAVA_OPTS $CATALINA_OPTS \
      -Djava.endorsed.dirs="$JAVA_ENDORSED_DIRS" -classpath "$CLASSPATH" \
      -Dcatalina.base="$CATALINA_BASE" \
      -Dcatalina.home="$CATALINA_HOME" \
      -Djava.io.tmpdir="$CATALINA_TMPDIR" \
      -Djava.awt.headless=true \

以tomcat6.0为例，总共有七处这样的地方。然后重启tomcat服务器，创建含图表的pdf时仍然报错，但是报的错不太一样了：

java.awt.HeadlessException
        at java.awt.GraphicsEnvironment.checkHeadless(GraphicsEnvironment.java:159)
        at java.awt.Window.(Window.java:406)
        at java.awt.Frame.(Frame.java:402)
        at java.awt.Frame.(Frame.java:367)
        at javax.swing.JFrame.(JFrame.java:163)

于是又上网去查，说是启动tomcat的用户无法访问Xserver，包括Xserver没有启动或者没有权限访问。那就启动一下Xserver呗，于是在终端键入命令startx后报错：

root@localhost:~#startx &

/etc/X11/xinit/xserverrc: line 3: /usr/bin/X: No such file or directory
/etc/X11/xinit/xserverrc: line 3: exec: /usr/bin/X: cannot execute: No such file or directory
xinit: giving up
xinit: unable to connect to X server: Connection refused
xinit: server error

我觉得可能是有一些依赖包没有安装，所以查找了一下，果然apt-get install xserver-xorg之后，X server可以正常启动了。然后我又照着网上所述配置了DISPLAY环境变量：

root@localhost:~#export DISPLAY=localhost:0.0

root@localhost:~#xhost +

然后重启tomcat服务器，再试还是不行，报错仍然如下：