JavaFX与Swing集成问题：点击Swing按钮打开JavaFX窗体失败

我之前也碰到过类似的情况——从Swing转JavaFX的项目里，跨窗体调用总是出各种线程异常。其实核心问题就是Swing和JavaFX分属不同的线程模型，JavaFX的组件必须在它自己的Application Thread里创建和操作，直接在Swing的事件线程里调用肯定会出问题。结合Maven项目的配置，给你一套完整的解决步骤：

一、先检查Maven配置是否到位 #

首先确保你的pom.xml里已经正确引入了JavaFX依赖，并且插件配置正确（尤其是模块部分），不然容易出现模块访问异常：

<dependencies>
    <!-- 根据你的JavaFX版本调整，这里用21做示例 -->
    <dependency>
        <groupId>org.openjfx</groupId>
        <artifactId>javafx-controls</artifactId>
        <version>21</version>
    </dependency>
    <dependency>
        <groupId>org.openjfx</groupId>
        <artifactId>javafx-fxml</artifactId>
        <version>21</version>
    </dependency>
</dependencies>

<build>
    <plugins>
        <plugin>
            <groupId>org.openjfx</groupId>
            <artifactId>javafx-maven-plugin</artifactId>
            <version>0.0.8</version>
            <executions>
                <execution>
                    <id>default-cli</id>
                    <configuration>
                        <!-- 这里填你启动Swing窗体的主类全路径 -->
                        <mainClass>com.yourpackage.SwingMainFrame</mainClass>
                        <addModules>javafx.controls,javafx.fxml</addModules>
                    </configuration>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

二、核心代码实现：线程隔离+JavaFX初始化 #

关键要做两件事：

1. 确保JavaFX运行时已经初始化（如果是从Swing启动的，JavaFX不会自动初始化）
2. 所有JavaFX相关的操作必须切换到FX Application Thread执行

下面是完整的Swing窗体示例代码，包含按钮点击打开JavaFX窗口的逻辑：

import javax.swing.*;
import java.awt.event.ActionEvent;
import java.awt.event.ActionListener;
import javafx.application.Platform;
import javafx.scene.Scene;
import javafx.scene.control.Label;
import javafx.scene.layout.StackPane;
import javafx.stage.Stage;

public class SwingMainFrame extends JFrame {
    public SwingMainFrame() {
        setTitle("Swing主界面");
        setSize(400, 300);
        setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
        setLocationRelativeTo(null);

        JButton openFxBtn = new JButton("打开JavaFX窗口");
        openFxBtn.addActionListener(new ActionListener() {
            @Override
            public void actionPerformed(ActionEvent e) {
                // 判断JavaFX是否已初始化，未初始化则先启动运行时
                if (!Platform.isInitialized()) {
                    // Platform.startup会初始化JavaFX，并且在FX线程执行传入的逻辑
                    Platform.startup(() -> showJavaFXWindow());
                } else {
                    // 已初始化，直接在FX线程执行窗口显示逻辑
                    Platform.runLater(() -> showJavaFXWindow());
                }
            }
        });

        add(openFxBtn);
    }

    // 封装JavaFX窗口创建逻辑，必须在FX线程调用
    private void showJavaFXWindow() {
        Stage fxStage = new Stage();
        fxStage.setTitle("JavaFX弹窗");
        
        // 这里可以换成你自己的JavaFX布局或FXML加载逻辑
        StackPane root = new StackPane();
        root.getChildren().add(new Label("成功打开JavaFX窗口！"));
        
        Scene scene = new Scene(root, 400, 300);
        fxStage.setScene(scene);
        fxStage.show();
    }

    public static void main(String[] args) {
        // Swing组件必须在EDT线程启动，这是Swing的规范
        SwingUtilities.invokeLater(() -> {
            new SwingMainFrame().setVisible(true);
        });
    }
}

三、常见异常排查 #

如果还是出现异常，对照下面的情况排查：

• IllegalStateException: Toolkit not initialized：说明JavaFX运行时没初始化，检查是否调用了Platform.startup()，注意这个方法只能调用一次，多次调用会报错。
• 模块访问异常（比如java.lang.IllegalAccessError）：检查pom.xml里的addModules是否包含了所有用到的JavaFX模块，比如用了FXML就要加javafx.fxml。
• JavaFX窗口不显示：确保stage.show()是在FX线程里调用的，另外检查窗口大小是否设置合理，有没有被Swing窗口遮挡。

四、如果用FXML加载JavaFX窗口 #

如果你的JavaFX界面是用FXML写的，只需要修改showJavaFXWindow()方法即可，同样要保证在FX线程执行：

private void showJavaFXWindow() {
    try {
        FXMLLoader loader = new FXMLLoader(getClass().getResource("/com/yourpackage/views/YourFXView.fxml"));
        javafx.scene.Parent root = loader.load();
        Stage fxStage = new Stage();
        fxStage.setTitle("FXML驱动的JavaFX窗口");
        fxStage.setScene(new Scene(root, 600, 400));
        fxStage.show();
    } catch (Exception e) {
        e.printStackTrace();
        JOptionPane.showMessageDialog(SwingMainFrame.this, "加载FXML失败：" + e.getMessage());
    }
}

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