JavaFX：通过FXML获取BorderPane后setCenter(SubScene)无法显示内容

下面是针对这个问题的排查方向和修复方案：

1. 确认FXML与控制器的绑定是否正确 #

• 检查FXML文件里的BorderPane必须带有fx:id="borderPane"属性，比如：

  <BorderPane fx:id="borderPane" ...>
      <!-- 其他区域布局 -->
  </BorderPane>
  

• 控制器类里必须用@FXML注解绑定这个BorderPane，并且getBorderPane()返回的是这个实例，不能是新建的对象：

  public class YourController {
      @FXML
      private BorderPane borderPane;
  
      public BorderPane getBorderPane() {
          return borderPane;
      }
      // 其他代码
  }
  

如果绑定错误，你拿到的BorderPane根本不是FXML里的目标布局，设置Center自然不会生效。

2. 处理SubScene的尺寸适配问题 #

FXML里的BorderPane可能带有默认布局约束，导致SubScene被挤压或超出可视范围：

• 给SubScene绑定BorderPane的尺寸，让它自动适配父容器：

  subScene.prefWidthProperty().bind(borderpane.widthProperty());
  subScene.prefHeightProperty().bind(borderpane.heightProperty());
  

• 先清空BorderPane的Center区域原有占位控件（比如SceneBuilder中添加的空Pane），再添加SubScene：

  borderpane.setCenter(null); // 先清空原有内容
  borderpane.setCenter(subScene);
  

3. 确保Scene的根节点正确 #

代码中的root必须是FXML加载后的根节点，否则等于把SubScene加到了未被显示的布局上：

// 正确加载FXML的方式
FXMLLoader loader = new FXMLLoader(getClass().getResource("your_layout.fxml"));
Parent root = loader.load();
YourController controller = loader.getController();

// 获取控制器绑定的BorderPane并设置SubScene
BorderPane borderpane = controller.getBorderPane();
borderpane.setCenter(subScene);

Scene scene = new Scene(root, 600, 600);
stage.setScene(scene);

4. 显式设置SubScene的相机 #

虽然你把camera加到了Group中，但显式设置相机可以避免潜在的渲染异常：

subScene.setCamera(camera);

5. 手动触发布局刷新 #

有时候添加控件后JavaFX不会自动刷新布局，手动调用即可：

borderpane.requestLayout();

调整后的完整代码示例 #

// 在start方法中加载FXML并设置SubScene
FXMLLoader loader = new FXMLLoader(getClass().getResource("your_layout.fxml"));
Parent root = loader.load();
YourController controller = loader.getController();

Group objects = setGroup(width, height);
Group group = new Group(objects, camera, spot, light);
SubScene subScene = new SubScene(group, 600, 550, true, SceneAntialiasing.BALANCED);
subScene.setCamera(camera);

BorderPane borderpane = controller.getBorderPane();
borderpane.setCenter(null);
borderpane.setCenter(subScene);

// 绑定尺寸适配父容器
subScene.prefWidthProperty().bind(borderpane.widthProperty());
subScene.prefHeightProperty().bind(borderpane.heightProperty());

borderpane.requestLayout();

Scene scene = new Scene(root, 600, 600);
stage.setScene(scene);
stage.show();

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