应提前预防并适配环境以避免HeadlessException：检查GraphicsEnvironment.isHeadless()跳过GUI操作；禁用或替换GUI依赖（如OpenCV用imwrite、OpenFace加-no_gui）；必要时用xvfb模拟显示；避免误设-Djava.awt.headless=true。
直接捕获 HeadlessException 并不能解决问题，它只是异常结果，不是处理手段。真正有效的方式是**提前预防 + 环境适配**，避免走到抛出异常那一步。
检查并跳过 GUI 操作
在创建任何 AWT/Swing 组件（如 JFrame、JDialog、Toolkit.getDefaultToolkit().getImage()）前，先确认环境是否支持图形界面：
- 调用
GraphicsEnvironment.isHeadless()判断当前是否为无头模式 - 返回
true时，应完全绕过 GUI 初始化逻辑，改用日志、文件输出或纯数据结构替代 - 不要依赖 try-catch 包裹
new JFrame()—— 异常已发生，资源可能部分分配，逻辑易混乱
禁用或替换依赖 GUI 的功能
很多库默认启用图形能力，但提供无界面开关：
- OpenCV：使用
cv2.imshow()前加if not os.environ.get('DISPLAY'):判断；或统一用cv2.imwrite()保存结果 - OpenFace：必须加
-no_gui参数，否则 highgui 模块必然触发HeadlessException - Java 图表库（如 JFreeChart）：导出为 PNG 字节数组而非显示窗口，用
ChartUtilities.saveChartAsPNG()
必要时模拟图形环境
当业务逻辑强依赖 GUI 组件（如打印预览、字体度量、图像缩放），且无法重构时，可用虚拟显示方案：
- Linux 服务器安装
xvfb：sudo apt install xvfb - 启动虚拟屏：
Xvfb :99 -screen 0 1024x768x24 & - 运行 Java 程序前设置：
export DISPLAY=:99 - 注意：该方式消耗内存，不适用于高并发短生命周期任务
避免误设系统属性
某些部署脚本或容器镜像会全局设置 -Djava.awt.headless=true，导致即使有图形环境也被强制禁用：
- 检查启动命令、
java -XshowSettings:properties -version输出中的java.awt.headless - 如需启用 GUI，显式覆盖：
-Djava.awt.headless=false - 但注意：仅在真实具备 X11 显示服务的环境中设置
false，否则仍会失败
