macOS 12.0.1加载含类簇的XIB抛NSClassSwapper异常如何解决？

异常原因 #

macOS 12.0.1开始，NSCoder对NIB/XIB解档过程新增了实例一致性校验：如果在init/initWithCoder:方法中替换返回的实例与coder预先创建的占位实例不一致，就会触发你遇到的报错。旧版系统没有这项校验，所以原实现可以正常运行。

可行解决方案 #

方案1：将实例替换逻辑迁移到awakeAfterUsingCoder:（最推荐） #

awakeAfterUsingCoder:是系统专门提供的解档后实例替换入口，在这里返回替换后的实例不会触发coder的一致性校验，完全符合AppKit的解档规则。
代码修改示例：

// 去掉原有init方法中的单例替换逻辑，仅保留基础初始化
- (instancetype)init {
    self = [super init];
    return self;
}

// 解档完成后替换为单例
- (id)awakeAfterUsingCoder:(NSCoder *)coder {
    static dispatch_once_t onceToken;
    dispatch_once(&onceToken, ^{
        HelpLinkHelperSingleton = self;
        // 补充你原本的单例初始化逻辑
    });
    return HelpLinkHelperSingleton;
}

原有<NSSecureCoding>协议的实现保留即可，不需要额外修改。

方案2：使用占位对象透传 #

如果不想修改原有单例的实现逻辑，可以在XIB中放置一个普通NSObject占位对象，自定义占位对象的实现，在awakeFromNib之后将所有消息转发到你的单例实例，也可以避开解档校验问题。

注意事项 #

• 不要在init、initWithCoder:的执行过程中替换self，这是触发macOS 12+解档校验失败的核心原因
• 原有单例的初始化逻辑建议补充dispatch_once保证线程安全，避免多线程场景下出现重复初始化的问题

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