# 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. 添加了异常处理，防止图形界面初始化失败导致整个应用崩溃

这些改进确保了应用程序在各种环境下都能稳定运行，无论是否支持图形界面。