JavaFX启动报错：Location未设置，FXML路径及控制器位置疑问

我来帮你捋清楚这个JavaFX的问题，你遇到的java.lang.IllegalStateException: Location is not set本质就是程序找不到你的FXML文件，咱们一步步解决：

这是核心症结，既然你已经把FXML放到resources文件夹了，重点要掌握基于类路径的正确加载方式：

• 用getClass().getResource()加载（最常用）
  假设你的resources文件夹结构是这样的（比如FXML文件叫MainView.fxml）：

  src/main/resources/
      MainView.fxml
  

  那加载代码应该这么写：

  FXMLLoader loader = new FXMLLoader(getClass().getResource("/MainView.fxml"));
  

  注意开头的/，它代表从类路径的根目录开始查找。如果你的FXML在resources的子文件夹里，比如resources/ui/MainView.fxml，那路径就要写成/ui/MainView.fxml。

• 用ClassLoader加载
  这种方式不需要加开头的/，同样从类路径根开始找，代码示例：

  FXMLLoader loader = new FXMLLoader(ClassLoader.getSystemResource("MainView.fxml"));
  

• 踩坑提醒

  • 确保你的构建工具（Maven/Gradle）或者IDE已经把resources文件夹标记为资源根目录（比如IDEA里右键文件夹选「Mark Directory as -> Resources Root」），这样打包时才会把FXML文件放到类路径里。
  • 路径大小写必须完全匹配！Java类路径是区分大小写的，mainview.fxml和MainView.fxml会被当成两个不同的文件。

完全不需要！你把控制器放在UI文件夹是完全合理的，绝对不需要把控制器移到resources文件夹（resources是放资源文件的，控制器属于Java代码，应该放在src/main/java下的包结构里）。

要让FXML正确关联控制器，有两种靠谱方式：

1. 在FXML文件里指定控制器全类名
   比如你的控制器是com.example.ui.MainController，就在FXML的根标签里添加属性：

   <?xml version="1.0" encoding="UTF-8"?>
   <AnchorPane xmlns="http://javafx.com/javafx"
               xmlns:fx="http://javafx.com/fxml"
               fx:controller="com.example.ui.MainController">
       <!-- 界面元素代码 -->
   </AnchorPane>
   

2. 在Java代码里手动设置控制器
   如果你不想在FXML里硬编码全类名，也可以在加载时手动绑定：

   FXMLLoader loader = new FXMLLoader(getClass().getResource("/MainView.fxml"));
   loader.setController(new MainController());
   Parent root = loader.load();
   

• 检查你的Main类启动代码是否完整，正确的启动逻辑大概是这样的：

  @Override
  public void start(Stage primaryStage) throws IOException {
      FXMLLoader loader = new FXMLLoader(getClass().getResource("/MainView.fxml"));
      Parent root = loader.load();
      primaryStage.setTitle("你的应用标题");
      primaryStage.setScene(new Scene(root));
      primaryStage.show();
  }
  
  public static void main(String[] args) {
      launch(args);
  }
  

• 如果是模块化项目（有module-info.java），要确保在模块声明里开放控制器包给FXML访问：

  module your.module.name {
      requires javafx.controls;
      requires javafx.fxml;
  
      opens com.example.ui to javafx.fxml; // 让FXML框架能访问你的控制器包
  }
  

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