Linux服务器启动GWT 2.8.2 DevMode遇Headless异常求助

你遇到的问题核心是传统GWT DevMode依赖SwingUI图形界面，而Linux服务器通常是无头（无X11图形环境）的，所以两种headless参数设置都会触发异常：

• 设-Djava.awt.headless=false时，JVM尝试连接X11服务器但失败；
• 设true时，SwingUI试图创建窗口，违反无头模式限制抛出HeadlessException。

下面提供三种可行的解决方案，按推荐程度排序：

方案1：切换到GWT Super Dev Mode（推荐） #

GWT 2.7+已经用Super Dev Mode替代了传统DevMode，它完全基于浏览器和命令行，不需要任何图形界面，非常适合服务器环境。

启动命令示例（替换为你的项目路径和模块名）：

java -cp "war/WEB-INF/lib/*:war/WEB-INF/classes" com.google.gwt.dev.codeserver.CodeServer -src src/ com.yourpackage.YourModule

启动后，在本地浏览器访问http://<服务器IP>:9876，点击"Dev Mode On"按钮加载你的GWT模块，即可正常进行开发调试。

方案2：使用Xvfb虚拟X服务器（保留传统DevMode） #

如果必须使用传统DevMode，可以通过Xvfb创建一个虚拟的X11图形环境，让SwingUI能够正常启动：

1. 安装Xvfb（根据你的Linux发行版选择命令）：

   • Debian/Ubuntu：sudo apt-get install xvfb
   • RHEL/CentOS：sudo yum install xorg-x11-server-Xvfb

2. 启动虚拟X服务器：

   Xvfb :1 -screen 0 1024x768x16 &
   

3. 设置DISPLAY变量指向虚拟服务器：

   export DISPLAY=:1
   

4. 启动DevMode（保持-Djava.awt.headless=false）：

   java -Djava.awt.headless=false -cp "war/WEB-INF/lib/*:war/WEB-INF/classes" com.google.gwt.dev.DevMode -war war -src src com.yourpackage.YourModule
   

方案3：指定无头UI启动传统DevMode #

GWT提供了HeadlessUI实现，可以绕过SwingUI的图形依赖，直接用命令行交互：

启动命令示例：

java -Djava.awt.headless=true -cp "war/WEB-INF/lib/*:war/WEB-INF/classes" com.google.gwt.dev.DevMode -ui com.google.gwt.dev.shell.HeadlessUI -war war -src src com.yourpackage.YourModule

这种方式不需要任何图形环境，也能使用传统DevMode的核心功能，只是没有可视化调试窗口，所有操作通过命令行完成。

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