JavaFX中FXMLLoader在非控制器类调用时@FXML注解失效如何解决

你猜测的问题和FXMLLoader在非控制器类调用无关，核心原因是当前代码产生了两个完全独立的Controller实例：

1. JavaFX的launch()方法启动应用时，会自动创建一个Controller类（你将它作为了Application的子类）的实例，你在start方法里访问的label属于这个实例
2. FXMLLoader加载FXML时，读取到fx:controller="Issue.Controller"的配置，会再创建一个全新的Controller实例，FXML里的@FXML字段只会注入到这个新实例里
   两个实例毫无关联，所以你在start方法里访问的label自然是null。

方案1：手动指定FXMLLoader的控制器，复用Application实例 #

修改Creator类的createStage方法，让它接收Controller实例作为参数，手动给FXMLLoader设置控制器，同时删掉FXML里的fx:controller配置（手动设置就不需要在FXML里声明了）
修改后的Creator.java：

public class Creator {
    public static Stage createStage(Stage stage, Controller controller)  {
        Parent root = null;
        String pathToProject = System.getProperty("user.dir");
        Path path = Paths.get(pathToProject, "src", "main", "java", "Issue", "Scene.fxml");
        try{
            URL url = new URL("file", "", path.toString());
            // 不要用静态load方法，创建FXMLLoader实例手动配置
            FXMLLoader fxmlLoader = new FXMLLoader(url);
            // 手动指定控制器，复用当前的Application实例
            fxmlLoader.setController(controller);
            root = fxmlLoader.load();
        } catch (IOException | NullPointerException e) {
            System.out.println("wrong url to fxml");
            e.printStackTrace();
        }
        stage.setScene(new Scene(root, 400, 400));
        return stage;
    }
}

修改Controller的start方法调用：

@Override
public void start(Stage stage) throws Exception {
    // 把当前的Controller实例传进去
    stage = Creator.createStage(stage, this);
    stage.show();
    System.out.println("Is label null?");
    if(label == null){
        System.out.println("yes");
    } else {
        System.out.println("no");
        // 这里可以正常操作label
        System.out.println(label.getText());
    }
}

最后删除Scene.fxml里的fx:controller="Issue.Controller"属性即可。

方案2：从FXMLLoader中获取注入完成的控制器实例 #

如果不想把Application和控制器逻辑耦合，可以拆分Application类和Controller类，然后在Creator里加载完成后把控制器返回给调用方使用，更符合JavaFX分层规范：
首先拆分启动类和控制器：

// 单独的Application启动类
package Issue;
import javafx.application.Application;
import javafx.stage.Stage;
public class App extends Application {
    public static void main(String[] args) {
        launch(args);
    }
    @Override
    public void start(Stage stage) throws Exception {
        // 接收Creator返回的stage和控制器实例
        var result = Creator.createStage(stage);
        Stage newStage = result.stage();
        Controller controller = result.controller();
        newStage.show();
        // 直接用返回的控制器操作节点
        System.out.println(controller.getLabel().getText());
    }
}

// 单独的Controller类，无需继承Application
package Issue;
import javafx.fxml.FXML;
import javafx.scene.control.Label;
public class Controller {
    @FXML
    private Label label;
    // 提供getter访问节点
    public Label getLabel() {
        return label;
    }
}

修改Creator类，返回stage和控制器的组合：

package Issue;
import javafx.fxml.FXMLLoader;
import javafx.scene.Parent;
import javafx.scene.Scene;
import javafx.stage.Stage;
import java.io.IOException;
import java.net.URL;
import java.nio.file.Path;
import java.nio.file.Paths;

// 新增结果类用来返回两个对象，也可以用自定义普通类实现
record StageAndController(Stage stage, Controller controller) {}

public class Creator {
    public static StageAndController createStage(Stage stage)  {
        Parent root = null;
        Controller controller = null;
        String pathToProject = System.getProperty("user.dir");
        Path path = Paths.get(pathToProject, "src", "main", "java", "Issue", "Scene.fxml");
        try{
            URL url = new URL("file", "", path.toString());
            FXMLLoader fxmlLoader = new FXMLLoader(url);
            root = fxmlLoader.load();
            // 从loader中获取FXMLLoader创建并注入完成的控制器实例
            controller = fxmlLoader.getController();
        } catch (IOException | NullPointerException e) {
            System.out.println("wrong url to fxml");
            e.printStackTrace();
        }
        stage.setScene(new Scene(root, 400, 400));
        return new StageAndController(stage, controller);
    }
}

你当前加载FXML的路径写法有问题，打包成jar后会找不到文件，建议改成类路径加载的方式：

// 替换掉原来的路径拼接和URL创建逻辑
URL url = Creator.class.getResource("Scene.fxml");

只要Scene.fxml和Creator类在同一个包下，就能正常加载，开发环境和打包后的jar环境都适用。

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