使用storyboard.instantiateViewController后向下转型失败求助

遇到这种转型失败的问题真的很头疼，明明已经在Storyboard里指定了类，怎么还是转不过去？我之前也碰到过几次，总结了几个最常见的原因和解决办法，你可以挨个排查：

• Storyboard中ViewController的类或模块配置错误
  虽然你说已经指定了类，但很容易忽略「模块」这个细节，尤其是多模块项目或者用了CocoaPods的情况。打开Storyboard，选中目标TableViewController，切换到右侧的Identity Inspector（第三个图标）：

  • 确认Class字段准确填写了PresenceTableViewController，注意大小写和拼写
  • 检查Module选项：如果你的自定义类在主项目中，选择项目名；如果在子模块中，选择对应的模块名。也可以勾选「Inherit Module From Target」来自动匹配目标模块
    有时候Xcode会自动填充错误的模块，导致实例化的是系统的UITableViewController而非你的子类。

• Storyboard中ViewController的类型选错了
  你的PresenceTableViewController是UITableViewController的子类，那Storyboard里必须拖入Table View Controller（而非普通的View Controller再添加TableView）。如果拖的是普通ViewController，哪怕指定了子类，实例化出来的本质还是UIViewController，转型自然会失败。
  你可以在Storyboard的文档大纲里查看这个VC的类型，确认是UITableViewController。

• 类名冲突或命名空间问题
  项目中可能存在重名的类，或者Swift与OC混编时出现命名冲突。你可以尝试在转型时加上模块名来明确指定：

  presenceViewController = storyboard.instantiateViewController(withIdentifier: "userPresenceTable") as! YourProjectName.PresenceTableViewController
  

  如果这样能成功，说明确实是命名空间的问题，需要排查项目中是否有其他同名类。

• Storyboard引用或ID错误
  确认你获取的storyboard对象是正确的——如果你的PresenceTableViewController不在Main.storyboard里，那用UIStoryboard(name: "Main", bundle: nil)实例化肯定会出错。另外，检查Storyboard里VC的Storyboard ID是否和代码中的"userPresenceTable"完全一致，Swift是区分大小写的，哪怕多一个空格都会导致错误。

• Xcode缓存或编译问题
  有时候Xcode的缓存会导致类的元数据异常，尝试以下操作：

  1. 按下Cmd+Shift+K清理Build Folder
  2. 按下Cmd+B重新编译项目
  3. 重启Xcode，或者手动删除Derived Data（路径在Xcode偏好设置→Locations→Derived Data）

另外，给你一个调试小技巧：在转型前先打印实例的类型，看看实际是什么：

let tempVC = storyboard.instantiateViewController(withIdentifier: "userPresenceTable")
print("实际类型：\(type(of: tempVC))")

如果输出的是UITableViewController，那说明实例化的根本不是你的自定义子类，重点排查前几个原因；如果输出的是你的子类，那可能是转型时的写法问题（不过这种情况很少见）。

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