Three.js中地球倾斜不影响太阳夹角计算的问题排查

核心问题分析 #

你的代码存在两个关键缺陷，导致地球倾斜角度无法对计算结果产生影响：

1. 公转旋转被完全抵消 #

通过sun.rotation.y = yrot和earthRotationFrame.rotation.y = -yrot的组合，地球的公转效果被彻底抵消。地球相对于太阳的位置始终固定在(earthOrbitDistance, 0, 0)，太阳方向永远指向-x轴，倾斜角无法通过公转让地球表面点的太阳夹角产生季节性变化。

2. 矩阵更新顺序错误 #

在updateCelestialPositions中，先调用scene.updateMatrixWorld(true)再设置地球自转角度，导致自转的旋转无法反映到后续的世界位置计算中，进一步掩盖了倾斜角的影响。

修复方案 #

1. 重构层级旋转逻辑，取消公转抵消 #

将公转旋转直接作用于地球轨道框架（earthRotationFrame），让太阳保持在世界原点静止，彻底取消反向抵消的操作：

public updateCelestialPositions(time: number): void {
  const minuteOfDay = this.minutesInDay * (time % 1);

  // 公转：地球轨道框架绕太阳（世界y轴）旋转
  const orbitalRot = (time * 2 * Math.PI) / this.daysInYear;
  this.earthRotationFrame.rotation.y = orbitalRot;

  // 自转：地球绕自身y轴旋转（y轴已被倾斜框架调整为倾斜状态）
  const spinRot = (minuteOfDay / this.minutesInDay) * 2 * Math.PI;
  this.earth.rotation.y = spinRot;

  // 最后统一更新所有对象的世界矩阵
  this.scene.updateMatrixWorld(true);
}

同时在构造函数中，保持太阳在原点静止，无需旋转：

// 构造函数中移除太阳旋转相关操作，仅保留基础初始化
this.sun = new Object3D(); // 太阳固定在世界原点

2. 修正矩阵更新顺序 #

确保所有旋转参数设置完成后，再调用updateMatrixWorld，这样所有对象的最新变换都会被正确计算。

3. 验证倾斜角的作用 #

此时，地球倾斜框架（earthTiltFrame）的rotation.x会改变地球自转轴的方向，结合公转和自转，地球表面点的太阳夹角会随季节（公转位置）和时间（自转）变化，倾斜角的影响会直接体现在计算结果中。

完整修复后的关键代码片段 #

// 构造函数关键部分
constructor(
  public name: string,
  cursor: SimTimeCursor,
  maxDeclinationDeg: number,
  private earthOrbitDistance: number = 1.496e8
) {
  this.daysInYear = cursor.cal.daysInYear;
  this.minutesInDay = cursor.cal.hoursInDay * 60;
  this.maxDeclination = MathUtils.degToRad(maxDeclinationDeg);

  this.scene = new Scene();
  this.sun = new Object3D(); // 太阳固定在世界原点
  this.earth = new Object3D();
  this.earthRotationFrame = new Object3D();
  this.earthTiltFrame = new Object3D();
  this.earthTiltFrame.rotation.x = this.maxDeclination; // 倾斜角直接作用于自转轴

  this.pointObject = new Object3D();
  this.earth.add(this.pointObject);
  this.earthTiltFrame.add(this.earth);
  this.earthRotationFrame.add(this.earthTiltFrame);
  this.earth.position.set(this.earthOrbitDistance, 0, 0); // 地球在倾斜框架的x轴方向（公转轨道半径）
  this.sun.add(this.earthRotationFrame);
  this.scene.add(this.sun);

  [
    this.earth,
    this.sun,
    this.earthTiltFrame,
    this.earthRotationFrame,
    this.pointObject,
  ].forEach((o) => (o.matrixAutoUpdate = true));
}

// 更新天体位置方法
public updateCelestialPositions(time: number): void {
  const minuteOfDay = this.minutesInDay * (time % 1);

  // 公转：轨道框架绕y轴旋转
  const orbitalRot = (time * 2 * Math.PI) / this.daysInYear;
  this.earthRotationFrame.rotation.y = orbitalRot;

  // 自转：地球绕自身y轴旋转
  const spinRot = (minuteOfDay / this.minutesInDay) * 2 * Math.PI;
  this.earth.rotation.y = spinRot;

  // 最后更新所有世界矩阵
  this.scene.updateMatrixWorld(true);
}

修复原理 #

• 取消公转抵消后，地球会随公转轨道框架绕太阳旋转，不同季节地球相对于太阳的位置和自转轴倾斜方向的相对关系会变化，倾斜角的影响会体现在太阳夹角中。
• 修正矩阵更新顺序后，自转和公转的最新变换都会被正确计算，确保点的世界位置准确反映当前的天体位置。

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