錯誤現象

執行 JasperReport 報表時拋出：

Caused by: java.lang.NoClassDefFoundError
    at java.lang.Class.forName0(Native Method)
    at java.awt.GraphicsEnvironment.getLocalGraphicsEnvironment(...)

根因分析

Linux 圖形處理 (AWT) 依賴 X Server。兩種情況觸發錯誤：

1. 系統未安裝圖形介面 (無 X Server)
2. 已裝 X Server 但記憶體不足無法啟動圖形環境

一鍵修復：啟用 JDK Headless 模式

JDK 內建無頭模式 (Headless) 可在無顯示硬體/ X Server 環境下執行圖形操作 (如報表渲染、圖表生成)。

1. 編輯 JBoss 啟動配置 run.conf
2. 在 JAVA_OPTS 追加：-Djava.awt.headless=true
3. 重啟 JBoss 即時生效

無需安裝 X Window、無需顯示卡、記憶體占用極低，是伺服器端報表生成的標準解法。