JavaFX报错：FXML控制器类中未找到对应id的可注入字段

这个报错的核心原因很明确：你在FXML文件里给按钮设置了fx:id="LoginBtn"，但对应的LoginController类里没有声明匹配的可注入字段，导致JavaFX无法将FXML中的控件和控制器关联起来。

修复步骤 #

1. 在控制器类中，为FXML里每个带fx:id的控件声明对应的成员变量，变量名必须和fx:id完全一致（大小写敏感）
2. 给每个变量加上@FXML注解，让FXML加载器能识别并注入这些控件

修改后的完整控制器代码 #

import java.net.URL;
import java.util.ResourceBundle;
import javafx.fxml.FXML;
import javafx.fxml.Initializable;
import javafx.scene.control.Button;
import javafx.scene.control.Label;
import javafx.scene.control.TextField;

public class LoginController implements Initializable {

    // 对应FXML中的fx:id="LoginBtn"
    @FXML
    private Button LoginBtn;
    
    // 对应FXML中的fx:id="txt_user"
    @FXML
    private TextField txt_user;
    
    // 其他带fx:id的控件如果需要用到，也按同样方式声明
    @FXML
    private Label WelcomeBack;
    @FXML
    private Label Sign_In;
    @FXML
    private Label Password;
    @FXML
    private Label Username;
    @FXML
    private Label label_Budo;

    @Override
    public void initialize(URL url, ResourceBundle rb) {
        // 示例：给登录按钮绑定点击事件
        LoginBtn.setOnAction(event -> {
            String username = txt_user.getText();
            System.out.println("输入的用户名：" + username);
        });
    }
}

额外注意事项 #

• 变量访问修饰符用private即可，JavaFX会通过反射完成注入，不需要设为public
• 务必保证变量名和FXML中的fx:id严格匹配，大小写不能出错
• 检查FXML中的fx:controller="LoginController"是否和控制器类的全限定名一致，如果控制器在某个包下，要写成fx:controller="你的包名.LoginController"

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