JavaFX应用WebView配置疑问：如何为其指定Scene？

我一直在尝试让WebView在我的JavaFX应用中运行，但不知道怎么操作。作为JavaFX新手，我不确定是否需要为WebView指定Scene，曾尝试复制现有场景切换方法来配置，但没成功。

控制器代码 #

package com.adventureg147.mclauncher;

import javafx.event.ActionEvent;
import javafx.fxml.FXML;
import javafx.fxml.FXMLLoader;
import javafx.fxml.Initializable;
import javafx.scene.Node;
import javafx.scene.Parent;
import javafx.scene.Scene;
import javafx.scene.control.Button;
import javafx.scene.control.Label;
import javafx.scene.control.TextField;
import javafx.scene.image.Image;
import javafx.scene.layout.*;
import javafx.scene.shape.Circle;
import javafx.stage.Stage;
import javafx.scene.web.WebEngine;
import javafx.scene.web.WebHistory;
import javafx.scene.web.WebView;

import java.io.IOException;
import java.net.URL;
import java.util.EventObject;
import java.util.ResourceBundle;

public class Controller implements Initializable{

    @FXML
    private WebView webView;
    private WebEngine engine;

    @Override
    public void initialize(URL url, ResourceBundle resourceBundle) {
        engine = webView.getEngine();
        loadPage();
    }
    public void loadPage() {
        engine.load("https://www.google.com/");

    }


    @FXML
    private Stage stage;
    private Scene scene;
    private Parent root;

    public void switchToMP(ActionEvent event) throws IOException {
        root = FXMLLoader.load(getClass().getResource("MPMenu.fxml"));
        stage = (Stage)((Node)event.getSource()).getScene().getWindow();
        scene = new Scene(root);
        stage.setScene(scene);
        stage.show();
    }

    public void switchToShop(ActionEvent event) throws IOException {
        root = FXMLLoader.load(getClass().getResource("ShopMenu.fxml"));
        stage = (Stage)((Node)event.getSource()).getScene().getWindow();
        scene = new Scene(root);
        stage.setScene(scene);
        stage.show();
    }

    public void switchToNews(ActionEvent event) throws IOException {
            root = FXMLLoader.load(getClass().getResource("NewsMenu.fxml"));
            stage = (Stage)((Node)event.getSource()).getScene().getWindow();
            scene = new Scene(root);
            stage.setScene(scene);
            stage.show();
    }

}

上述控制器包含场景切换与WebView加载两部分功能。

目标Scene的FXML代码 #

<?xml version="1.0" encoding="UTF-8"?>

<?import javafx.scene.control.Button?>
<?import javafx.scene.image.Image?>
<?import javafx.scene.image.ImageView?>
<?import javafx.scene.layout.AnchorPane?>
<?import javafx.scene.shape.Rectangle?>
<?import javafx.scene.text.Font?>
<?import javafx.scene.web.WebView?>

<AnchorPane maxHeight="-Infinity" maxWidth="-Infinity" minHeight="-Infinity" minWidth="-Infinity" prefHeight="800.0" prefWidth="1250.0" style="-fx-background-color: RoyalBlue;" xmlns="http://javafx.com/javafx/21" xmlns:fx="http://javafx.com/fxml/1" fx:controller="com.adventureg147.mclauncher.Controller">
   <children>
      <Rectangle arcHeight="5.0" arcWidth="5.0" fill="DODGERBLUE" height="90.0" stroke="TRANSPARENT" strokeType="INSIDE" width="1250.0" />
      <Button layoutX="87.0" layoutY="1.0" mnemonicParsing="false" onAction="#switchToMP" prefHeight="90.0" prefWidth="250.0" style="-fx-background-color: dodgerblue;" text="MODPACKS">
         <font>
            <Font name="Lato Light" size="32.0" />
         </font>
      </Button>
      <Button layoutX="472.0" mnemonicParsing="false" onAction="#switchToNews" prefHeight="90.0" prefWidth="135.0" style="-fx-background-color: #1177da;" text="NEWS">
         <font>
            <Font name="Lato Light" size="32.0" />
         </font>
      </Button>
      <Button layoutX="337.0" mnemonicParsing="false" onAction="#switchToShop" prefHeight="90.0" prefWidth="135.0" style="-fx-background-color: dodgerblue;" text="SHOP">
         <font>
            <Font name="Lato Light" size="32.0" />
         </font>
      </Button>
      <ImageView fitHeight="87.0" fitWidth="87.0" layoutY="2.0" pickOnBounds="true" preserveRatio="true">
         <image>
            <Image url="@../../../icon.png" />
         </image>
      </ImageView>
      <WebView fx:id="webView" layoutY="89.0" prefHeight="712.0" prefWidth="1250.0" />
   </children>
</AnchorPane>

主类代码 #

package com.adventureg147.mclauncher;

import javafx.application.Application;
import javafx.fxml.FXMLLoader;
import javafx.scene.Group;
import javafx.scene.Parent;
import javafx.scene.Scene;
import javafx.scene.control.Button;
import javafx.scene.image.Image;
import javafx.scene.input.KeyCombination;
import javafx.scene.layout.*;
import javafx.scene.paint.Color;
import javafx.scene.shape.Line;
import javafx.scene.text.Font;
import javafx.scene.text.Text;
import javafx.stage.Stage;
import javafx.stage.StageStyle;

import java.text.NumberFormat;

public class MCLauncher extends Application {

    public static void main(String[] args) {

        launch();
    }

    @Override
    public void start(Stage MenuMain) throws Exception{
        Parent root = FXMLLoader.load(getClass().getResource("LoginMenu.fxml"));
        Scene scene = new Scene(root);

        Image icon = new Image("icon.png");
        MenuMain.getIcons().add(icon);
        MenuMain.setResizable(false);

        MenuMain.setTitle("MC Launcher");
        MenuMain.setScene(scene);
        MenuMain.show();
    }

}

问题排查与修复 #

WebView无需单独绑定Scene，只要它被正确嵌入FXML布局，加载FXML时就会自动成为当前Scene的一部分。你的代码框架没问题，大概率是以下细节出错：

1. FXML路径错误：确认NewsMenu.fxml（含WebView的目标页面）与Controller类处于同一包下，或getClass().getResource("NewsMenu.fxml")路径写法正确（子包需加./subpackage/NewsMenu.fxml）。
2. FXML注入失败：检查FXML中WebView的fx:id是否为webView，必须与控制器中@FXML private WebView webView变量名完全一致，否则webView会为null，引发空指针异常。
3. 页面加载受限：部分网站会检测客户端特征，拒绝JavaFX WebEngine访问。可先替换为https://example.com测试加载逻辑；同时确保应用具备网络访问权限。

调试步骤 #

• 在initialize方法开头添加System.out.println(webView);，若输出null，说明FXML注入失败，重点检查fx:id和文件路径。
• 给WebEngine添加加载状态监听，定位失败原因：

import javafx.concurrent.Worker;

// 在loadPage方法中添加
engine.getLoadWorker().stateProperty().addListener((obs, oldState, newState) -> {
    if (newState == Worker.State.SUCCEEDED) {
        System.out.println("页面加载完成");
    } else if (newState == Worker.State.FAILED) {
        System.err.println("加载失败: " + engine.getLoadWorker().getException().getMessage());
    }
});

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