Windows宿主机CentOS7 Docker容器运行Java Swing GUI报错问题咨询

首先排除Linux发行版适配问题，你遇到的报错是Java Swing依赖X11图形服务导致的：

java.awt.HeadlessException: No X11 DISPLAY variable was set, but this program performed an operation which requires it.

上述报错的核心原因是容器运行环境内没有可用的X11显示服务，也没有配置对应DISPLAY环境变量，而Swing作为图形化组件必须依赖X11渲染能力才能运行。

你要求的「镜像独立运行、宿主机无需安装额外软件」的需求完全可以实现，根据使用场景可选两种实现方案：

方案1：内置Xvfb虚拟显示（无窗口输出场景，适合自动化测试） #

如果不需要在宿主机查看Swing应用窗口，仅需应用正常运行不报错，可在镜像内集成Xvfb虚拟帧缓存服务模拟X11环境：

• 镜像构建阶段安装依赖：yum install -y xorg-x11-server-Xvfb libXext libXrender libXtst
• 编写容器启动脚本，启动Java应用前执行如下命令初始化虚拟显示：

export DISPLAY=:1
Xvfb :1 -screen 0 1024x768x16 &

启动Java应用后即可避免HeadlessException报错。

方案2：内置VNC+Web访问能力（需查看窗口场景） #

如果需要操作Swing应用的图形界面，可在镜像内集成VNC服务和noVNC网页客户端，宿主机仅需浏览器即可访问界面：

• 镜像构建阶段除Java环境外，额外安装tigervnc-server、noVNC、xfce轻量桌面
• 配置VNC访问密码，将noVNC服务绑定到容器端口（比如8080）
• 容器启动时映射8080端口到宿主机，宿主机直接访问http://localhost:8080即可进入桌面操作Swing应用，全程不需要宿主机安装任何额外软件。

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