如何在Spring Boot应用中触发Processing Sketch运行？

问题原因 #

Spring Boot默认以headless模式启动（java.awt.headless=true），该模式下JVM不会初始化图形显示上下文；同时Processing的PApplet依赖AWT/Swing的UI线程，直接在Spring Boot主线程调用会导致图形上下文缺失，从而触发报错。

解决方案 #

1. 禁用Spring Boot的Headless模式 #

关闭headless模式，让JVM正常初始化图形环境：

• 方式一：修改启动类代码

package io.eho.foo;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class FooApplication {
    public static void main(String[] args)
    {
        SpringApplication application = new SpringApplication(FooApplication.class);
        // 禁用headless模式
        application.setHeadless(false);
        application.run(args);
    }
}

• 方式二：通过配置文件设置
  在src/main/resources/application.properties中添加：

spring.main.headless=false

2. 在UI专用线程中启动Processing Sketch #

Processing的图形窗口必须在AWT/Swing的事件调度线程（Event Dispatch Thread）中创建，直接在Spring业务线程调用会引发上下文异常。使用SwingUtilities.invokeLater将Sketch启动逻辑提交到UI线程：

示例：在需要触发Sketch的业务逻辑中（如Controller、Service）：

import javax.swing.SwingUtilities;
import io.eho.foo.play.sketchtest.PlaySketch;
import processing.core.PApplet;

// 触发Sketch的方法
public void launchProcessingSketch() {
    SwingUtilities.invokeLater(() -> {
        String[] processingArgs = {"PlaySketch"};
        PlaySketch playSketch = new PlaySketch();
        PApplet.runSketch(processingArgs, playSketch);
    });
}

3. 检查IntelliJ运行配置 #

确保IntelliJ的Spring Boot运行配置中没有添加-Djava.awt.headless=true这类VM参数，若存在则删除。

说明 #

以上方案适用于本地开发环境（有物理显示设备），如果是部署到无图形界面的服务器环境，才需要考虑虚拟显示方案（如Xvfb），但你明确不需要无显示运行，因此上述方案即可解决问题。

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