Spring Boot集成JavaFX启动报错：META-INF/spring.factories无自动配置

我之前在使用springboot-javafx-support开发Spring Boot+JavaFX应用时也碰到过一模一样的问题，这个错误基本都是因为Gradle构建脚本没有正确配置Spring Boot的插件和依赖，导致自动配置所需的spring.factories文件没有被打包到应用中。结合你给出的部分build.gradle内容，我给你梳理一下修正方案：

一、补全并修正Gradle核心配置 #

你的build.gradle里的Spring Boot插件依赖没写完，而且缺少了关键的插件应用声明，以下是完整的可运行配置示例：

buildscript {
    ext {
        springBootVersion = '2.0.1.RELEASE'
        // 保持springboot-javafx-support版本和Spring Boot版本一致，避免兼容性问题
        javafxSupportVersion = '2.0.1.RELEASE'
    }
    repositories {
        mavenCentral()
    }
    dependencies {
        // 必须引入Spring Boot Gradle插件，这是处理自动配置文件打包的核心
        classpath("org.springframework.boot:spring-boot-gradle-plugin:${springBootVersion}")
        // 引入依赖管理插件，统一管控依赖版本
        classpath("io.spring.gradle:dependency-management-plugin:1.0.6.RELEASE")
    }
}

apply plugin: 'java'
// 应用Spring Boot插件，自动处理打包和自动配置文件
apply plugin: 'org.springframework.boot'
// 应用依赖管理插件
apply plugin: 'io.spring.dependency-management'

repositories {
    mavenCentral()
}

dependencies {
    // Spring Boot核心启动依赖
    implementation("org.springframework.boot:spring-boot-starter")
    // springboot-javafx-support核心依赖
    implementation("de.roskenet:springboot-javafx-support:${javafxSupportVersion}")
    // 如果你的项目用到了FXML或其他JavaFX组件，按需添加JavaFX依赖（Java 8自带JavaFX，Java11+需要手动引入）
    // implementation('org.openjfx:javafx-controls:11')
    // implementation('org.openjfx:javafx-fxml:11')
}

// 配置Spring Boot主类，替换成你自己的主类全路径
springBoot {
    mainClassName = 'com.yourpackage.YourJavaFxApp'
}

二、检查主类的正确写法 #

除了Gradle配置，还要确保你的主类符合springboot-javafx-support的要求，必须继承AbstractJavaFxApplicationSupport并标注@SpringBootApplication，示例如下：

import de.roskenet.springbootjavafxsupport.AbstractJavaFxApplicationSupport;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class YourJavaFxApp extends AbstractJavaFxApplicationSupport {

    public static void main(String[] args) {
        // 用框架提供的launchApp方法启动应用，而不是JavaFX原生的launch
        launchApp(YourJavaFxApp.class);
    }

    // 如果你需要自定义JavaFX启动逻辑，可以重写start方法
    // @Override
    // public void start(Stage stage) throws Exception {
    //     super.start(stage);
    //     // 你的自定义代码
    // }
}

三、为什么这样配置能解决问题？ #

• Spring Boot Gradle插件：这个插件会自动识别并打包Spring Boot自动配置所需的META-INF/spring.factories文件，没有它的话，这些关键配置文件会被Gradle忽略，导致启动时找不到自动配置项。
• 版本一致性：springboot-javafx-support的版本必须和Spring Boot版本匹配，否则会出现兼容性问题，也可能导致自动配置加载失败。
• 正确的启动方式：使用框架提供的launchApp方法启动，而不是JavaFX原生的launch，这样才能让Spring Boot和JavaFX的上下文正确初始化。

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