JavaFX太阳系模拟异常：仅显示部分太阳纹理，无法查看完整布局

核心问题定位 #

程序无法正常显示和运行，根源在于尺度失衡、初始化错误、动画逻辑bug三个方面：

1. 真实天文单位与视觉渲染尺度完全不匹配，导致天体要么过大超出视野，要么过远无法看到
2. 太阳半径修改未同步到渲染用的Sphere对象
3. 地球初始速度为0，无法产生绕日运动
4. 动画中错误地持续将所有天体沿Z轴后移，导致天体快速脱离视野
5. 重力公式使用真实物理常数，与缩小后的尺度不匹配，运动计算失效

具体修复步骤 #

1. 统一视觉尺度，调整天体参数 #

将真实天文数据按比例缩小到适合JavaFX渲染的范围，修改MainApp中的initSolarSystem方法：

private SolarSystem initSolarSystem() {
    SolarSystem solarSystem = new SolarSystem();

    // 缩小尺度：太阳半径100，地球半径10，日地距离1500（视觉单位）
    CelestialBody sun = new CelestialBody("Sun", 1.989e30, 100, new Vector3D(0, 0, 0), new Vector3D(0, 0, 0), "sun.jpg");
    solarSystem.addBody(sun);

    // 给地球初始切向速度，使其绕太阳运行（Z轴速度200适配当前尺度）
    CelestialBody earth = new CelestialBody("Earth", 5.972e24, 10, new Vector3D(1500, 0, 0), new Vector3D(0, 0, 200), "earth.jpg");
    solarSystem.addBody(earth);

    return solarSystem;
}

2. 同步太阳半径到渲染Sphere #

MainApp中修改太阳半径时，需要调用SolarSystemSimulation的setRadius方法，同步更新渲染用的Sphere：

@Override
public void start(Stage stage) throws Exception {
    SolarSystem solarSystem = initSolarSystem();
    SolarSystemSimulation simulation = new SolarSystemSimulation(solarSystem);

    Scene scene = new Scene(simulation, 1200, 900);
    scene.setFill(javafx.scene.paint.Color.BLACK);

    PerspectiveCamera camera = new PerspectiveCamera();
    camera.setTranslateZ(-5000); // 调整相机距离，适配新尺度
    camera.setFarClip(10000);
    scene.setCamera(camera);

    stage.setScene(scene);
    stage.show();

    simulation.start();

    // 同步修改太阳的渲染半径
    CelestialBody sun = solarSystem.getBodies().get(0);
    simulation.setRadius(sun, 100);
}

3. 删除错误的Z轴后移逻辑 #

SolarSystemSimulation的start方法中，删除这段会让天体持续远离的代码：

// 删掉这段错误代码
/*
getChildren().forEach(child -> {
    if (child instanceof Sphere) {
        Sphere sphere = (Sphere) child;
        sphere.setTranslateZ(sphere.getTranslateZ() - 0.5);
    }
});
*/

4. 调整重力常数适配缩放尺度 #

因为我们缩小了天文尺度，真实的引力常数会导致引力过弱，修改SolarSystemSimulation中的重力常数：

private double calculateGravitationalForce(CelestialBody body1, CelestialBody body2, double distance) {
    // 放大引力常数适配视觉尺度
    final double gravitationalConstant = 6.67430e-5; 
    return gravitationalConstant * (body1.getMass() * body2.getMass()) / (distance * distance);
}

5. 确保纹理资源路径正确 #

确认sun.jpg和earth.jpg放在项目的resources根目录下，loadImage方法的路径无需修改。

验证运行 #

修复后运行程序，应该能看到：

• 黑色背景中央的太阳（带纹理）
• 地球绕太阳做圆周运动
• 所有天体保持在视野范围内

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