播放MP3时抛出java.lang.IllegalStateException: Toolkit not initialized异常求助

这个异常的核心原因是：JavaFX的媒体组件（Media、MediaPlayer）依赖JavaFX Toolkit，而Toolkit必须在JavaFX应用程序的专用线程中初始化——直接在普通main方法中创建这些组件，会跳过Toolkit的初始化流程，导致报错。

解决方案1：改用标准JavaFX Application结构（推荐） #

这是JavaFX官方推荐的程序结构，能自动完成Toolkit初始化，同时避免线程安全问题：

import javafx.application.Application;
import javafx.scene.media.Media;
import javafx.scene.media.MediaPlayer;
import javafx.stage.Stage;

import java.io.*;
import java.net.URL;
import java.nio.channels.Channels;
import java.nio.channels.ReadableByteChannel;

public class Main extends Application {
    int id = 467339;

    public static void main(String[] args) {
        // 启动JavaFX应用，自动初始化Toolkit
        launch(args);
    }

    @Override
    public void start(Stage primaryStage) {
        try {
            downloadFile(new URL("https://www.newgrounds.com/audio/download/" + id), id + ".mp3");
            Media media = new Media(new File(id + ".mp3").toURI().toString());
            MediaPlayer mediaPlayer = new MediaPlayer(media);
            mediaPlayer.play();

            // 保持应用运行（否则播放开始后程序会立即退出）
            primaryStage.setOnCloseRequest(event -> mediaPlayer.stop());
            primaryStage.show();
        } catch (IOException e) {
            e.printStackTrace();
        }
    }

    public void downloadFile(URL url, String outputFileName) throws IOException {
        try (InputStream in = url.openStream();
             ReadableByteChannel rbc = Channels.newChannel(in);
             FileOutputStream fos = new FileOutputStream(outputFileName)) {
            fos.getChannel().transferFrom(rbc, 0, Long.MAX_VALUE);
        }
    }
}

解决方案2：手动初始化Toolkit（非GUI场景适用） #

如果不需要JavaFX窗口，可通过创建JFXPanel（或JavaFX 9+用Platform.startup()）手动触发Toolkit初始化，同时确保媒体操作在JavaFX线程执行：

import javafx.scene.media.Media;
import javafx.scene.media.MediaPlayer;
import javafx.application.Platform;
import javafx.embed.swing.JFXPanel;

import java.io.*;
import java.net.URL;
import java.nio.channels.Channels;
import java.nio.channels.ReadableByteChannel;

public class Main {
    public static void main(String[] args) {
        // 手动初始化JavaFX Toolkit
        new JFXPanel(); 
        // JavaFX 9+也可以用：Platform.startup(() -> {});

        new Main();
    }
    
    int id = 467339;

    public Main(){
        try {
            downloadFile(new URL("https://www.newgrounds.com/audio/download/"+id),id+".mp3");
            // 媒体操作必须在JavaFX应用线程执行
            Platform.runLater(() -> {
                Media media = new Media(new File(id+".mp3").toURI().toString());
                MediaPlayer mediaPlayer = new MediaPlayer(media);
                mediaPlayer.play();
            });
        } catch (IOException e) {
            e.printStackTrace();
        }
    }

    public void downloadFile(URL url, String outputFileName) throws IOException {
        try (InputStream in = url.openStream();
             ReadableByteChannel rbc = Channels.newChannel(in);
             FileOutputStream fos = new FileOutputStream(outputFileName)) {
            fos.getChannel().transferFrom(rbc, 0, Long.MAX_VALUE);
        }
    }
}

额外注意事项 #

• 确保项目正确引入JavaFX依赖：Oracle JDK 8自带JavaFX，OpenJDK需要手动添加JavaFX SDK或通过构建工具（Maven/Gradle）引入依赖。
• 部分平台播放MP3可能需要额外的媒体编码库支持，若播放无声音，需检查平台的媒体解码环境。

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