如何修复Swift中SceneKit获取节点时解包Optional出现nil的致命错误？

这个崩溃触发的原因是!强制解包了nil的可选值：childNode(withName:recursively:)方法返回SCNNode?可选类型，当场景中没有找到对应名称的节点时就会返回nil，此时强制解包就会抛出你遇到的致命错误。

• 首先校验场景文件是否加载成功
  你当前的代码没有校验SCNScene初始化结果，如果art.scnassets/MainScene.scn文件不存在、路径拼写错误，scene本身就是nil，自然无法查找到任何子节点。可以先给场景初始化添加校验逻辑：

  func setupScene(){
      sceneView = self.view as! SCNView
      sceneView.delegate = self
      
      // 新增场景加载校验
      guard let scene = SCNScene(named: "art.scnassets/MainScene.scn") else {
          fatalError("MainScene.scn 加载失败，请检查文件路径是否正确")
      }
      self.scene = scene
      sceneView.scene = scene
      
      scene.physicsWorld.contactDelegate = self
      
      let tapRecognizer = UITapGestureRecognizer()
      tapRecognizer.numberOfTapsRequired = 1
      tapRecognizer.numberOfTouchesRequired = 1
      
      tapRecognizer.addTarget(self, action: #selector(GameViewController.sceneViewTapped(recognizer:)))
      sceneView.addGestureRecognizer(tapRecognizer)
  }
  

• 检查节点名称拼写
  确认MainScene.scn中节点的name属性严格匹配代码里的字符串，注意大小写敏感，多余的空格、拼写错误都会导致查找失败：
  • 球体节点名称必须是Ball
  • 自拍杆节点名称必须是selfieNode
• 替换强制解包为安全校验
  把setupNodes中的强制解包替换为可选绑定，出错时会输出明确的错误提示，方便定位：

  func setupNodes() {
      guard let ballNode = scene.rootNode.childNode(withName: "Ball", recursively: true) else {
          fatalError("场景中未找到名为Ball的节点，请检查场景编辑器中的节点配置")
      }
      self.ballNode = ballNode
      ballNode.physicsBody?.contactTestBitMask = CategoryLamp
      
      guard let selfieStickNode = scene.rootNode.childNode(withName: "selfieNode", recursively: true) else {
          fatalError("场景中未找到名为selfieNode的节点，请检查场景编辑器中的节点配置")
      }
      self.selfieStickNode = selfieStickNode
  }
  

• （可选）代码生成节点
  如果你不想通过场景编辑器添加节点，也可以直接用代码生成球体节点：

  // 代码生成Ball节点示例，可直接放在setupNodes中
  let ballGeo = SCNSphere(radius: 1)
  let ballMaterial = SCNMaterial()
  ballMaterial.diffuse.contents = UIColor.systemBlue // 可替换为纹理图片
  ballGeo.materials = [ballMaterial]
  let ballNode = SCNNode(geometry: ballGeo)
  ballNode.name = "Ball"
  ballNode.position = SCNVector3(0, 2, 0) // 初始位置可自行调整
  ballNode.physicsBody = SCNPhysicsBody(type: .dynamic, shape: SCNPhysicsShape(geometry: ballGeo, options: nil))
  scene.rootNode.addChildNode(ballNode)
  self.ballNode = ballNode
  

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