JavaFX项目读取本地视频文件报错原因及正确实现方法

一、报错的核心原因 #

先看你写的这段代码：

File f = new File("test.mp4");
URI u = f.toURI();
private static final String MEDIA_URL = "u";

这里犯了两个低级但致命的错误：

1. 字符串字面量误用：你把字符串 "u" 赋值给了 MEDIA_URL，而不是变量 u 存储的实际URI值。JavaFX拿到的是纯文本 "u"，这根本不是一个合法的URI——它没有协议头（比如file://），所以才会抛出uri.getScheme() == null! uri == 'u'的异常。
2. 静态常量初始化逻辑错误：private static final 是类级别的静态常量，而你前面的File f和URI u是方法内的局部变量，静态常量的初始化时机早于方法执行，就算你写MEDIA_URL = u.toString()也会编译报错，因为静态成员不能直接引用方法内的局部变量。

二、正确加载本地test.mp4的两种方法 #

方式1：静态常量直接生成合法URI（适合固定视频场景） #

直接在静态常量的初始化代码里生成文件的URI字符串，一步到位：

// 假设test.mp4和你的项目编译后的class文件在同一目录（IDE运行时就是项目根目录）
private static final String MEDIA_URL = new File("test.mp4").toURI().toString();

// 如果是绝对路径，比如Windows下要注意转义反斜杠：
// private static final String MEDIA_URL = new File("D:\\myVideos\\test.mp4").toURI().toString();

也可以用Java 7+的Path API更简洁：

private static final String MEDIA_URL = Paths.get("test.mp4").toUri().toString();

方式2：在start方法中动态加载（适合需要切换视频的场景） #

如果不想用静态常量，直接在启动方法里动态创建Media对象：

@Override
public void start(Stage primaryStage) {
    File videoFile = new File("test.mp4");
    // 先判断文件是否存在，避免找不到文件的异常
    if (!videoFile.exists()) {
        System.err.println("找不到test.mp4文件，请检查路径！");
        return;
    }
    Media media = new Media(videoFile.toURI().toString());
    // 后续创建MediaPlayer、MediaView等逻辑...
}

⚠️ 注意：要保证test.mp4的路径正确——IDE运行时，相对路径的基准是项目根目录；打包成jar后，基准是jar文件所在的文件夹。

三、JavaFX项目中读取文件的常见场景 #

1. 读取用户本地文件（可交互选择） #

用FileChooser让用户自己选择文件，这是媒体播放器的常用交互方式：

FileChooser fileChooser = new FileChooser();
fileChooser.setTitle("选择视频文件");
fileChooser.getExtensionFilters().add(
    new FileChooser.ExtensionFilter("MP4视频", "*.mp4"),
    new FileChooser.ExtensionFilter("所有视频", "*.mp4", "*.avi", "*.mkv")
);
File selectedFile = fileChooser.showOpenDialog(primaryStage);
if (selectedFile != null) {
    Media media = new Media(selectedFile.toURI().toString());
    // 加载并播放视频...
}

2. 读取项目内嵌资源文件（打包到jar里） #

如果想把视频和程序打包在一起，把test.mp4放到项目的src/main/resources目录（Maven/Gradle项目），或者直接放到src目录（普通JavaFX项目），然后用类加载器读取：

// 路径相对于resources目录，开头的/不能少
URL resourceUrl = getClass().getResource("/test.mp4");
if (resourceUrl == null) {
    System.err.println("资源文件test.mp4不存在，请检查resources目录！");
    return;
}
Media media = new Media(resourceUrl.toString());

这种方式的好处是用户不用单独管理视频文件，程序打包后可以直接运行。

3. 跨平台路径注意事项 #

• 尽量避免硬编码路径分隔符（Windows的\、Linux的/），可以用File.separator或者Paths API自动适配：

  // 跨平台的路径写法
  File videoFile = new File("videos" + File.separator + "test.mp4");
  

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