JavaFX+Spring Boot打包Jar无法运行：Location未设置

我之前在开发JavaFX结合Spring Boot的项目时，也踩过这个一模一样的坑——IDE里启动完全正常，打包成Jar用java -jar命令运行就报java.lang.IllegalStateException: Location is not set，明明Jar里能看到FXML文件就是加载不到。咱们来拆解下问题根源，再给你几个靠谱的解决方案：

问题根源分析 #

IDE运行时，你的类和FXML资源都在本地文件系统的目录里，getClass().getResource()可以直接访问到这些文件；但Spring Boot的可执行Jar是特殊的嵌套结构（资源都在BOOT-INF/classes下），用普通的类加载方式访问Jar内资源时，容易因为类加载器的差异（Spring Boot用的是LaunchedURLClassLoader）导致路径解析失败。

解决方案 #

方案1：用Spring的ResourceLoader加载资源（最推荐） #

Spring的ResourceLoader可以完美适配Jar内的资源访问，不管是IDE环境还是Jar运行环境都能正确识别。修改你的init方法如下：

@Override
public void init() throws Exception {
    springContext = SpringApplication.run(AnotherProjectApplication.class);
    // 获取Spring的资源加载器
    ResourceLoader resourceLoader = springContext.getResourceLoader();
    // 用classpath前缀指定资源路径
    Resource fxmlResource = resourceLoader.getResource("classpath:/com/X/anotherProject/view/Welcome.fxml");
    
    FXMLLoader fxmlLoader = new FXMLLoader();
    // 设置FXML的URL或者直接传入InputStream
    fxmlLoader.setLocation(fxmlResource.getURL());
    // 保持Spring的控制器工厂配置
    fxmlLoader.setControllerFactory(AnotherProjectApplication.springContext::getBean);
    // 加载FXML
    rootNode = fxmlLoader.load();
    
    springContext.getAutowireCapableBeanFactory().autowireBean(this);
}

这种方式完全利用Spring的资源管理机制，避免了类加载器的兼容性问题。

方案2：改用类加载器的getResource方法 #

把getClass().getResource()换成getClass().getClassLoader().getResource()，注意路径要去掉开头的/（因为类加载器的getResource是从classpath根目录开始查找的）：

@Override
public void init() throws Exception {
    springContext = SpringApplication.run(AnotherProjectApplication.class);
    // 用类加载器获取资源，路径去掉开头的/
    URL fxmlUrl = getClass().getClassLoader().getResource("com/X/anotherProject/view/Welcome.fxml");
    FXMLLoader fxmlLoader= new FXMLLoader(fxmlUrl);
    
    springContext.getAutowireCapableBeanFactory().autowireBean(this);
    fxmlLoader.setControllerFactory(AnotherProjectApplication.springContext::getBean);
    rootNode=fxmlLoader.load();
}

类加载器的getResource方法会直接从classpath根目录查找资源，能正确识别Jar内的BOOT-INF/classes下的文件。

方案3：确保资源文件被正确打包 #

虽然你已经确认Jar里有FXML文件，但还是要检查下Maven/Gradle的资源配置，确保FXML文件被正确复制到编译后的classes目录。比如Maven的pom.xml里要加上：

<build>
    <resources>
        <!-- 加载resources目录下的资源 -->
        <resource>
            <directory>src/main/resources</directory>
            <includes>
                <include>**/*.fxml</include>
                <include>**/*.css</include>
                <include>**/*.png</include>
            </includes>
        </resource>
        <!-- 如果FXML放在java目录下，需要添加这个配置 -->
        <resource>
            <directory>src/main/java</directory>
            <includes>
                <include>**/*.fxml</include>
            </includes>
        </resource>
    </resources>
</build>

如果你的FXML文件是放在src/main/java的包目录下，这个配置能确保它们被打包到Jar里。

总结 #

优先推荐方案1，因为它和Spring Boot的生态完全融合，能避免大部分类加载器相关的问题。方案2是快速修复的方式，适合不想改动太多代码的场景。

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