JavaFX应用启动时报Java找不到大量符号的问题求助

你遇到的大量“找不到符号”报错，核心是Java模块化环境下的模块权限边界限制，连带资源加载失败引发的连锁类解析错误，和导入语句缺失没有关系。

• 补全module-info.java的模块开放权限
  当前的模块配置只给javafx.fxml开放了controller子包的访问权限，但FXMLLoader运行时需要反射访问主类所在的父包、以及父包下绑定的fxml资源文件，模块封装拦截会直接导致类与资源的符号解析失败。调整后的模块配置参考：

  module marcin.scanner {
      requires javafx.graphics;
      requires javafx.controls;
      requires javafx.fxml;
      requires javafx.media;
      requires libphonenumber;
      requires lombok;
      requires org.slf4j;
      requires java.desktop;
      requires org.apache.logging.log4j;
  
      exports com.marcin.gui.scenebuilder to javafx.graphics;
      // 开放父包给JavaFX FXML组件，覆盖子包的资源与类访问权限
      opens com.marcin.gui.scenebuilder to javafx.fxml;
      opens com.marcin.gui.scenebuilder.controller to javafx.fxml;
  }
  

• 修正资源加载的路径逻辑
  1. 你代码中new Image("banana.png")的写法在模块化JavaFX环境下存在路径兼容问题，容易引发空指针连锁报错，调整为通过类加载器读取资源流的写法：

     stage.getIcons().add(new Image(getClass().getResourceAsStream("/banana.png")));
     

  2. 核对fxml文件的实际存放路径：确保mainPane.fxml实际位于src/main/resources/fxml/目录下，不要错放到java源码目录。fxml路径加载失败会导致FXMLLoader拿到空内容，解析时会抛出大量找不到对应控件类、找不到绑定符号的报错。
• 解决Lombok引发的类符号缺失问题
  如果项目依赖Lombok做代码生成，需要额外开放对应包给Lombok的注解处理器，否则编译阶段生成的构造方法、getter/setter等类符号会完全无法被识别：
  在模块配置中追加opens com.marcin.gui.scenebuilder to lombok;即可。
• 清除旧编译缓存
  因为IDE的导入提示没有标红，大概率是增量编译的产物残留了旧的模块边界配置，删掉项目build目录下的缓存文件，重新执行完整编译，大部分因缓存导致的符号识别错误会直接消失。

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