Swift5中实例化ImageViewController触发初始化器不可用崩溃求助

核心原因 #

Swift 5对类初始化器的合成规则做了更严格的检查，旧版本Swift中可能允许自定义初始化器但不实现init?(coder:)（storyboard实例化必须依赖的初始化器），但升级后系统不再自动合成这个初始化器，导致从storyboard实例化时找不到可用的初始化方法，触发崩溃。

具体解决步骤 #

1. 补全ImageViewController的init?(coder:)初始化器 #

打开ImageViewController的代码，检查是否有自定义的指定初始化器（比如init(image: UIImage)），如果有，必须显式实现required init?(coder:)：

class ImageViewController: UIViewController {
    var image: UIImage?
    
    // 自定义指定初始化器（如果存在）
    init(image: UIImage) {
        self.image = image
        super.init(nibName: nil, bundle: nil)
    }
    
    // 必须补上这个初始化器，storyboard实例化依赖它
    required init?(coder: NSCoder) {
        super.init(coder: coder)
        // 若需要从storyboard配置中初始化参数，可在此处理
    }
}

如果自定义初始化器仅用于传递数据，更推荐使用convenience便利初始化器，这样系统会自动保留默认初始化器：

class ImageViewController: UIViewController {
    var image: UIImage?
    
    convenience init(image: UIImage) {
        self.init(nibName: nil, bundle: nil)
        self.image = image
    }
    
    // 显式写出更保险，Swift也会自动合成该初始化器
    required init?(coder: NSCoder) {
        super.init(coder: coder)
    }
}

2. 检查Storyboard配置 #

• 打开Main.storyboard，选中ImageViewController，在Identity Inspector面板中确认Class字段正确填写ImageViewController，Module选择当前App的target（不要留空）。
• 如果使用storyboard ID实例化，确保代码中调用的ID与storyboard配置一致：

// 实例化代码示例
guard let vc = storyboard?.instantiateViewController(withIdentifier: "ImageViewController") as? ImageViewController else {
    return
}
vc.image = croppedImage
navigationController?.pushViewController(vc, animated: true)

3. 排查是否禁用了初始化器 #

检查ImageViewController代码中是否用@available(*, unavailable)标记了init?(coder:)或默认初始化器，比如：

@available(*, unavailable)
required init?(coder: NSCoder) {
    fatalError("init(coder:) has not been implemented")
}

如果存在此类代码，要么删除禁用标记，要么修改为允许调用super.init(coder:)，否则storyboard无法实例化该控制器。

4. 检查第三方依赖（若有） #

如果ImageViewController继承自第三方库的控制器类，查看该库的Swift 5适配文档，确认其初始化器规则是否有变化，调整你的初始化方式以适配。

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