JavaFX运行报错：调用WebView.getEngine()时webView为null且页面空白

问题根因 #

一共存在3个核心错误，直接导致空指针异常和WebView不生效：

• 控制器类中需要从FXML注入的组件未加@FXML注解。btnSearch、webView、vBox都是FXML中定义的组件，必须加@FXML才能被FXMLLoader正确注入，未加注解的属性默认值为null，调用webView.getEngine()自然触发空指针异常。
• 你在main方法中手动实例化了WikiBooksController并手动调用了initialize()。FXMLLoader加载FXML时会自动实例化控制器、自动执行带@FXML注解的initialize()方法，你手动new的控制器没有绑定FXML的组件，所有注入属性都是null，手动调用initialize直接触发异常。
• Main类中声明的tfSearch、btnSearch、webView属于冗余代码，组件注入逻辑归控制器管理，Main类不需要重复声明。

开头的Gtk模块加载警告是Linux桌面环境的系统依赖缺失问题，不影响JavaFX程序运行，可以直接忽略。

修复后的代码 #

Main类 #

public class Main extends Application {
    @Override
    public void start(Stage stage) throws IOException {
        FXMLLoader fxmlLoader = new FXMLLoader(Main.class.getResource("wikibooks.fxml"));
        Scene scene = new Scene(fxmlLoader.load(), 1000, 550);
        stage.setScene(scene);
        stage.show();
    }
    public static void main(String[] args) {
        // 移除手动创建控制器、调用initialize的冗余代码
        launch();
    }
}

WikiBooksController类 #

public class WikiBooksController {
    @FXML
    private TextField tfSearch;
    @FXML // 补全组件注入注解
    private Button btnSearch;
    @FXML // 补全组件注入注解
    private WebView webView;
    @FXML // 补全组件注入注解
    private VBox vBox;
    @FXML
    public void initialize() {
        WebEngine engine = webView.getEngine();
        // 建议使用https，部分JavaFX版本默认拦截http明文请求
        engine.load("https://www.wikibooks.org");
    }
}

额外注意事项 #

• 确认FXML文件根节点的fx:controller属性已正确配置为控制器的全类名，示例：fx:controller="de.ab5.abgabe5.WikiBooksController"
• 确认FXML中所有组件的fx:id和控制器中对应的属性名完全一致，比如WebView的fx:id必须为webView
• 如果页面仍然加载失败，可以给WebEngine添加加载状态监听排查问题：

engine.getLoadWorker().stateProperty().addListener((obs, oldState, newState) -> {
    if (newState == Worker.State.FAILED) {
        System.out.println("加载失败原因：" + engine.getLoadWorker().getException());
    }
});

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