SceneKit运行时地板垂直显示，阴影配置异常求助

这问题我之前也碰到过类似的，SceneKit编辑器和运行时的节点变换有时候确实会有这种诡异的不一致，咱们一步步来排查解决：

1. 先排查是否有代码覆盖了地板节点的变换 #

这是最常见的原因——你在编辑器里调好的属性，可能被代码偷偷重置了：

• 检查viewDidLoad、场景加载回调（比如SCNSceneSourceDelegate相关方法）里，有没有对地板节点设置eulerAngles、transform或者orientation的代码？先把这些代码注释掉，再运行试试。
• 可以在运行时打印地板节点的欧拉角，确认编辑器设置是否生效：

  print(floorNode.eulerAngles)
  

  如果打印出来的数值和编辑器里设置的(-π/2, 0, 0)不一致，说明肯定是代码或者SceneKit加载时覆盖了设置。

2. 用变换矩阵替代欧拉角设置朝向 #

欧拉角偶尔会有万向锁或者解析bug，试试直接用变换矩阵设置地板朝向，稳定性更高：

// 绕X轴旋转-90度，和你编辑器里的操作等价
floorNode.transform = SCNMatrix4MakeRotation(-.pi/2, 1, 0, 0)

或者在编辑器里不用手动输入欧拉角，直接用旋转工具把地板拖到水平状态，再保存场景——这种可视化操作生成的变换矩阵，SceneKit加载时出错概率更低。

3. 解决阴影不显示的核心条件 #

当你不调欧拉角时地板垂直但没阴影，本质是阴影投射与接收的几何条件不满足：

• 确保地板节点的receivesShadow设为true，castsShadow设为false（它只需要接收阴影，不用自己投射）。
• 检查灯光设置：灯光的castsShadow必须开，同时调整shadowRadius（阴影模糊度）、shadowSampleCount（阴影采样数）参数，避免阴影太淡或者被环境光掩盖。
• 地板垂直时，它的法线方向和灯光方向夹角可能接近90度，导致阴影无法投射到表面上——这也是为什么你把地板转成水平后阴影才正常的原因。

4. 检查父节点的变换影响 #

如果地板是某个父节点的子节点，父节点的旋转/缩放会影响子节点的最终朝向：

• 确认父节点的eulerAngles是默认的(0,0,0)，没有额外变换。
• 可以把地板节点直接移到根节点下，排除父节点的干扰，再测试朝向和阴影。

5. 重置场景文件排除缓存问题 #

有时候SceneKit的.scn场景文件会出现奇怪的缓存状态，试试：

• 新建一个空白场景，重新添加所有节点。
• 手动调整地板到水平状态，保存后再运行，看问题是否消失。

内容的提问来源于stack exchange，提问作者wm.p1us