如何正确解码SharePlay数据？iOS/macOS多平台应用解码报错排查

核心原因 #

你看到的message、t字段不是代码中自行定义的，是SharePlay底层GroupSessionMessenger框架序列化消息时自动添加的内置封装字段，分别用来存储消息主体内容和类型标识。报错本质是系统解码时无法匹配到你定义的SharePlayModel数组类型，常见诱因有以下几种：

• 跨平台两端的SharePlayModel定义不一致：iOS端和macOS端的字段数量、类型、CodingKeys规则不匹配，或者存在嵌套属性未实现Codable协议的情况
• 类型归属模块不匹配：iOS和macOS端的项目模块名不同，Codable默认会校验类型所属的模块名，模块名不同会被判定为不同类型，无法找到对应解码器
• 收发类型不匹配：发送消息时传递的是单个SharePlayModel实例，接收时指定的解码类型为[SharePlayModel].self，或者收发类型反过来不匹配

修复方案 #

• 统一所有平台下SharePlayModel的定义，包括字段顺序、类型、CodingKeys，确保所有嵌套的属性类型都完整实现Codable协议
• 显式实现SharePlayModel的Codable编解码逻辑，不依赖编译器自动合成，避免跨平台自动合成规则差异导致的问题
• 给SharePlayModel添加全局类型标识，消除模块名差异带来的校验失败：

@objc(SharePlayModel)
struct SharePlayModel: Codable, Sendable {
    // 全平台统一的字段定义
}

• 核对收发逻辑的类型一致性，比如发送时传数组类型：

try await messenger.send([modelInstance])

接收时也要对应指定数组类型：

messenger.onReceive(of: [SharePlayModel].self) { models, sender in
    // 处理收到的数组数据
}

• 不要自定义解析SharePlay信使收到的原始数据，直接用系统提供的onReceive(of:)方法传入对应类型即可，底层会自动处理message、t等内置封装字段

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