新增打印机图像页面

docs/MACOS_HEADLESS_SOLUTION.md

@@ -0,0 +1,76 @@
+# macOS 系统上的 HeadlessException 解决方案
+
+## 问题描述
+
+在 macOS 系统上运行打印服务器时，可能会遇到 `java.awt.HeadlessException` 错误，错误信息类似：
+
+```
+Exception in thread "AWT-EventQueue-0" java.awt.HeadlessException
+    at java.desktop/java.awt.GraphicsEnvironment.checkHeadless(GraphicsEnvironment.java:166)
+    at java.desktop/java.awt.Window.<init>(Window.java:553)
+    at java.desktop/java.awt.Frame.<init>(Frame.java:428)
+    at java.desktop/javax.swing.JFrame.<init>(JFrame.java:224)
+    at com.goeing.printserver.main.gui.PrintQueueGUI.initializeGUI(PrintQueueGUI.java:58)
+```
+
+这个错误表明应用程序在无头模式（Headless Mode）下运行，但尝试创建图形界面组件。在 macOS 系统上，特别是在某些环境下（如远程会话、无显示器连接或特定的系统配置），Java 应用程序可能会自动进入无头模式。
+
+## 解决方案
+
+我们已经对应用程序进行了优化，以更好地处理无头模式。现在有以下几种方式可以解决这个问题：
+
+### 1. 使用命令行参数启用无头模式
+
+如果您知道系统不支持图形界面，可以在启动应用程序时明确指定无头模式：
+
+```bash
+java -Djava.awt.headless=true -jar goeingPrintServer.jar
+```
+
+### 2. 通过配置文件设置
+
+在 `application.properties` 文件中，我们添加了一个配置项：
+
+```properties
+# 在macOS系统上，如果遇到HeadlessException，可以设置为true强制使用无头模式
+app.force.headless=false
+```
+
+将此值设置为 `true` 可以强制应用程序以无头模式运行。
+
+### 3. 自动检测和适应
+
+应用程序现在会自动检测系统是否支持图形界面，并在不支持时自动切换到无头模式。在无头模式下：
+
+- 图形界面组件不会被初始化
+- 系统托盘图标不会显示
+- 通知功能将被禁用
+- 打印功能仍然正常工作
+
+## 无头模式下的功能
+
+在无头模式下，应用程序仍然可以通过以下方式使用：
+
+1. **REST API**：所有打印功能都可以通过 REST API 访问
+2. **WebSocket**：打印请求可以通过 WebSocket 连接发送
+3. **命令行**：可以通过命令行工具与应用程序交互
+
+## 日志输出
+
+当应用程序检测到无头模式时，会在日志中输出相关信息：
+
+```
+当前环境不支持图形界面，将以无头模式运行
+系统运行在无头模式下，通知功能将被禁用
+```
+
+## 技术说明
+
+我们通过以下方式改进了应用程序对无头模式的处理：
+
+1. 在应用启动时检测系统环境
+2. 在检测到无头模式时设置系统属性 `app.headless.mode=true`
+3. 所有图形界面组件在初始化前检查此属性
+4. 添加了异常处理，防止图形界面初始化失败导致整个应用崩溃
+
+这些改进确保了应用程序在各种环境下都能稳定运行，无论是否支持图形界面。