Ubuntu系统NetBeans运行JavaFX程序时加载canberra-gtk-module失败

一、解决「Location is required」空指针异常 #

这个异常是导致程序启动失败的核心问题，本质是FXML/CSS资源文件未被正确找到或打包，按以下步骤排查：

1. 核对资源文件路径 #

• 如果App.java位于com/example这类子包下，确保scene.fxml和styles.css放在src/main/resources/com/example/目录下（Gradle项目默认资源目录为src/main/resources，需与类的包结构完全对应）。
• 若资源直接放在src/main/resources根目录，修改资源获取代码：

  // 使用绝对路径（开头加/）
  Parent root = FXMLLoader.load(getClass().getResource("/scene.fxml"));
  scene.getStylesheets().add(getClass().getResource("/styles.css").toExternalForm());
  

  或者通过类加载器从资源根目录查找：

  Parent root = FXMLLoader.load(getClass().getClassLoader().getResource("scene.fxml"));
  scene.getStylesheets().add(getClass().getClassLoader().getResource("styles.css").toExternalForm());
  

2. 确认Gradle打包配置 #

• 检查build.gradle，确保未排除资源文件。使用JavaFX Gradle插件时，默认会自动打包src/main/resources下的文件；若自定义了sourceSets，需保证包含资源：

  sourceSets {
      main {
          resources {
              srcDirs = ["src/main/resources"]
          }
      }
  }
  

• 构建后解压生成的jar包，检查是否包含scene.fxml和styles.css，确认资源被正确打包。

3. 正确运行程序 #

在NetBeans中选择通过Gradle的run任务启动程序，而非直接运行App类，避免因运行上下文差异导致资源路径错误。

二、消除「Failed to load module canberra-gtk-module」警告 #

该警告不影响程序运行，是Ubuntu系统GTK库架构不匹配导致，可通过以下方式解决：

• 安装对应架构的模块（64位系统需补充安装32位版本）：

  sudo apt install libcanberra-gtk-module:i386 libcanberra-gtk3-module:i386
  

• 在NetBeans运行配置中添加环境变量：打开运行配置 → 环境变量 → 添加GTK_MODULES=""，跳过该模块加载。
• 强制使用GTK2：在VM启动参数中添加-Djdk.gtk.version=2，避免加载GTK3相关模块。

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