使用didSelectItem实现UICollectionViewCell跳转时遇解包nil崩溃

你遇到的错误信息如下：

Thread 1: Fatal error: Unexpectedly found nil while unwrapping an Optional value.

对应的代码片段：

override func collectionView(_ collectionView: UICollectionView, didSelectItemAt indexPath: IndexPath) { 
    let vc = storyboard?.instantiateViewController(withIdentifier: "twoVC") as? twoVC 
    self.navigationController?.pushViewController(vc!, animated: true) // 崩溃发生在这里
} 

class twoVC : UIViewController { 
    @IBOutlet var label : UILabel! 
    @IBOutlet var photo : UIImageView! 
}

问题原因 #

崩溃的直接原因是你用vc!强制解包了一个nil值——也就是说storyboard?.instantiateViewController(withIdentifier: "twoVC") as? twoVC这行代码返回了nil，导致强制解包触发致命错误。

具体排查&修复方案 #

• 检查Storyboard标识符是否匹配：打开你的Storyboard，找到twoVC对应的视图控制器，在右侧属性面板里确认Storyboard ID是twoVC，大小写、拼写必须和代码里完全一致，不能有任何偏差。
• 确认当前控制器能获取到正确的Storyboard实例：如果你的当前控制器不是通过Storyboard加载的，self.storyboard会是nil。这种情况下，你可以手动指定Storyboard来初始化目标控制器：

  let storyboard = UIStoryboard(name: "Main", bundle: nil) // "Main"替换成你实际的Storyboard文件名
  

• 验证目标控制器的类名关联：在Storyboard里选中twoVC，检查右侧Identity Inspector里的Custom Class是否设置为twoVC，确保类名没有拼写错误，并且模块选择正确（一般选当前项目）。

优化后的安全代码 #

把强制解包换成guard语句，既能避免崩溃，还能方便排查问题：

override func collectionView(_ collectionView: UICollectionView, didSelectItemAt indexPath: IndexPath) {
    // 优先使用当前控制器的storyboard，否则手动加载指定的Storyboard
    guard let targetStoryboard = self.storyboard ?? UIStoryboard(name: "Main", bundle: nil) else {
        print("无法获取Storyboard实例，请检查文件名")
        return
    }
    
    guard let vc = targetStoryboard.instantiateViewController(withIdentifier: "twoVC") as? twoVC else {
        print("初始化twoVC失败，请检查Storyboard ID和类名关联")
        return
    }
    
    // 顺便检查navigationController是否存在，避免另一个潜在的nil问题
    guard let navController = self.navigationController else {
        print("当前控制器不在导航栈中，无法push")
        return
    }
    
    navController.pushViewController(vc, animated: true)
}

另外提醒一下：twoVC里的label和photo这两个IBOutlet，也要确保在Storyboard里已经正确连接到对应的控件上，不然跳转到该页面后也可能触发类似的解包崩溃哦。

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