解决Maven JavaFX项目中package javafx.scene.media不可见及Media类无法解析的问题

你遇到的问题主要源于Java 9+的模块系统（JPMS）特性，加上代码里缺少必要的导入语句，下面一步步帮你解决：

1. 补充缺失的Import语句 #

你的App.java代码里使用了Media类，但没有添加对应的导入声明，这会直接导致编译器无法识别该类。在文件开头的import区域添加：

import javafx.scene.media.Media;

2. 添加module-info.java模块声明文件 #

从OpenJFX 11开始，JavaFX组件以模块化形式发布，而JDK 13默认启用模块系统，因此你需要显式声明项目依赖的JavaFX模块。

在项目的src/main/java目录下创建module-info.java文件，内容如下：

module com.mycompany.hellojavafxmaven {
    // 声明依赖的JavaFX模块
    requires javafx.controls;
    requires javafx.base;
    requires javafx.media;
    
    // 允许JavaFX的graphics模块访问应用包（启动应用时反射需要）
    opens com.mycompany.hellojavafxmaven to javafx.graphics;
}

其中opens语句是必须的：JavaFX的启动机制需要通过反射访问你的App类，因此必须将应用包开放给javafx.graphics模块。

3. 清理并重新构建项目 #

完成上述两步后，在NetBeans中执行以下操作：

• 右键项目 -> Clean and Build，让Maven重新处理依赖并编译代码
• 如果仍有异常，右键项目 -> Reload Project，让IDE重新识别模块配置

问题根源说明 #

在Java 9之前，JavaFX是JDK的一部分，类直接在类路径下，编译器可自动查找。但OpenJFX 11及以后版本成为独立的模块化库，必须通过模块系统声明依赖，否则编译器无法访问javafx.scene.media这类封装在模块内的包。你的Maven配置已经正确引入了javafx-media依赖，但缺少模块声明的话，编译器无法定位到对应模块中的包。

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