SwiftData复合属性异常与容器错误排查及解决方案咨询

问题原因拆解 #

• v1错误：SwiftData - Fatal error: Unexpected type for CompositeAttribute: MyDictionaryWrapper
  SwiftData默认仅支持原生类型（如String、Int、Date）或符合特定要求的可转换类型作为@Model类的属性，直接将自定义Codable类作为属性时，它无法自动解析该类型为可存储的复合属性。

• v2错误：Fatal error: failed to find a currently active container for MyDictionaryWrapper
  给MyDictionaryWrapper添加@Model标记后，它成为了独立的SwiftData模型实体，但创建ModelContainer时未将该类型加入模型列表，导致SwiftData找不到对应的容器上下文。

正确解决方向与修复步骤 #

有两种可行方案，根据业务需求选择：

方案1：将MyDictionaryWrapper作为值类型存储（推荐用于仅包装数据的场景） #

如果MyDictionaryWrapper仅用于封装字典数据，不需要单独作为实体查询，优先用此方案：

1. 将MyDictionaryWrapper改为值类型struct（SwiftData对值类型的transformable支持更稳定），保持Codable实现：

   struct MyDictionaryWrapper: Codable {
       var dict: [String: Any]
       // 自定义Codable实现（处理Any类型的序列化）
   }
   

2. 在Item类的对应属性上添加@Attribute(.transformable(by: nil))标记，让SwiftData自动通过Codable序列化该类型：

   @Model
   class Item {
       @Attribute(.transformable(by: nil))
       var wrapper: MyDictionaryWrapper?
       
       // 其他属性
       init(wrapper: MyDictionaryWrapper?) {
           self.wrapper = wrapper
       }
   }
   

   注意：如果必须用class类型，需额外实现NSCopying协议，否则可能出现数据一致性问题。

方案2：将MyDictionaryWrapper作为独立@Model实体（用于需单独查询/关联的场景） #

如果MyDictionaryWrapper需要作为独立实体被查询或与多个Item关联，用此方案：

1. 给MyDictionaryWrapper添加@Model标记，确保它是class类型：

   @Model
   class MyDictionaryWrapper: Codable {
       var dict: [String: Any]
       // 自定义Codable实现
       init(dict: [String: Any]) {
           self.dict = dict
       }
   }
   

2. 在Item类中用@Relationship建立关联关系，设置合适的删除规则：

   @Model
   class Item {
       @Relationship(deleteRule: .cascade)
       var wrapper: MyDictionaryWrapper?
       
       // 其他属性
       init(wrapper: MyDictionaryWrapper?) {
           self.wrapper = wrapper
       }
   }
   

3. 创建ModelContainer时，将两个模型类型都加入列表：

   let container = try ModelContainer(for: [Item.self, MyDictionaryWrapper.self])
   

是否需要重新规划数据建模？ #

• 若只是封装字典数据，方案1无需重新规划，仅需调整属性标记和类型结构即可。
• 若需要将Wrapper作为独立实体管理，方案2仅需补充关联关系和容器配置，属于对现有模型的微调，而非完全重新建模。

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