Java SpringBoot播放.mp4视频报错：MediaException无法创建播放器

核心报错原因分析 #

1. JavaFX初始化方式错误 #

你用Toolkit.getDefaultToolkit()初始化JavaFX是无效的，JavaFX的正确初始化需要触发其应用线程启动。在非JavaFX应用（如SpringBoot）中，需通过JFXPanel实例化隐式初始化JavaFX，且要确保操作在正确线程中执行。

2. 媒体文件路径访问错误 #

你用file:协议拼接相对路径src/main/resources/movies/IMG_0055.mp4存在问题：

• 开发环境下可能临时可用，但打包成jar后，资源文件嵌入jar内部，file:协议无法访问jar内资源。
• 正确做法是通过类加载器获取资源URL，而非直接拼接file路径。

3. JavaFX媒体依赖不完整 #

虽然你导入了javafx.scene.media相关类，但JavaFX媒体功能依赖平台特定原生库（如Windows的dll、Linux的so、Mac的dylib）。若依赖配置未包含对应平台的原生库，会导致无法创建媒体播放器。

4. 线程违规操作 #

JavaFX所有组件（MediaPlayer、MediaView、JFXPanel等）必须在JavaFX应用线程中创建和操作，但你的代码在Spring Controller的请求线程（普通Java线程）中直接创建这些组件，违反JavaFX线程模型，导致组件初始化失败。

修正后的代码示例 #

import javafx.application.Platform;
import javafx.embed.swing.JFXPanel;
import javafx.scene.Scene;
import javafx.scene.layout.BorderPane;
import javafx.scene.media.Media;
import javafx.scene.media.MediaPlayer;
import javafx.scene.media.MediaView;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.GetMapping;

import javax.swing.*;
import java.awt.*;
import java.net.URL;

@Controller
public class VideoPlayer {

    @GetMapping("/playVideo")
    public String playVideo(Model model) {
        try {
            // 获取资源的正确URL（支持开发环境和jar包环境）
            URL videoUrl = getClass().getResource("/movies/IMG_0055.mp4");
            if (videoUrl == null) {
                throw new RuntimeException("视频文件不存在");
            }

            // 确保在JavaFX应用线程中初始化组件
            Platform.runLater(() -> {
                // 初始化JFXPanel触发JavaFX环境启动
                new JFXPanel();

                // 创建媒体对象
                Media media = new Media(videoUrl.toExternalForm());
                MediaPlayer mediaPlayer = new MediaPlayer(media);
                mediaPlayer.setAutoPlay(true);

                MediaView mediaView = new MediaView(mediaPlayer);

                // 创建JavaFX场景
                BorderPane root = new BorderPane(mediaView);
                Scene scene = new Scene(root, 800, 600);

                // 创建Swing窗口并嵌入JavaFX组件
                JFrame frame = new JFrame("Video Player");
                frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
                frame.setSize(800, 600);

                JFXPanel fxPanel = new JFXPanel();
                fxPanel.setScene(scene);
                frame.setContentPane(fxPanel);

                frame.setVisible(true);
            });

        } catch (Exception e) {
            e.printStackTrace();
            model.addAttribute("error", "Error playing video: " + e.getMessage());
        }

        return "video";
    }
}

依赖配置说明（以Maven为例） #

确保pom.xml中包含完整的JavaFX媒体依赖，指定对应平台的classifier：

<dependencies>
    <!-- JavaFX 核心及媒体依赖 -->
    <dependency>
        <groupId>org.openjfx</groupId>
        <artifactId>javafx-controls</artifactId>
        <version>21</version>
    </dependency>
    <dependency>
        <groupId>org.openjfx</groupId>
        <artifactId>javafx-media</artifactId>
        <version>21</version>
        <!-- 根据你的操作系统选择classifier，比如windows、linux、mac -->
        <classifier>windows</classifier>
    </dependency>
</dependencies>

<!-- 用于自动处理平台依赖的插件 -->
<build>
    <plugins>
        <plugin>
            <groupId>org.openjfx</groupId>
            <artifactId>javafx-maven-plugin</artifactId>
            <version>0.0.8</version>
            <configuration>
                <mainClass>你的主类路径</mainClass>
            </configuration>
        </plugin>
    </plugins>
</build>

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