SwiftData无法检索已保存数据：SQL索引名称不匹配问题求助

问题重现 #

模型定义如下：

@Model public final class Position: Equatable, Identifiable {
  var zone: ZoneModel?
  @Relationship(deleteRule: .cascade, inverse: \Item.positions) 
  var items = [Item]()
  var name: String = ""
  var weight: Int = 0
  var weightAllowed: Int = 0
  
  init(name: String, weightAllowed: Int) {
    self.name = name
    self.weightAllowed = weightAllowed
  }
}

@Model public final class Item: Equatable, Identifiable {
  var form: FormModel?
  var positions = [Position]() // 未标记为@Relationship属性
  var count: Int = 0
  var weight: Int = 0

  init() {}
}

Position侧可正常存储和持久化items数组，但Item侧的反向关联在App重启后失效，SQL堆栈跟踪报错：

no such column: t1.Z_6POSITIONS in
"SELECT 0, t0.Z_PK
FROM Z_5POSITIONS t1
JOIN ZPOSITION t0
ON t0.Z_PK = t1.Z_6POSITIONS
WHERE t1.Z_5ITEMS = ? "

查看SQLite数据库发现，实际关联表列名为Z_5POSITIONS.Z_7POSITIONS，与查询语句中的Z_6POSITIONS不匹配，索引定义：

CREATE INDEX "Z_5POSITIONS_Z_7POSITIONS_INDEX" ON "Z_5POSITIONS" (
    "Z_7POSITIONS",
    "Z_5ITEMS"
);

核心原因 #

1. 反向关联未显式声明：Item模型的positions属性未添加@Relationship注解，SwiftData无法正确识别这是多对多关系的反向关联，导致元数据生成错误。
2. 数据库元数据与模型不匹配：早期模型变更未触发正确的迁移，导致SwiftData生成的查询依赖旧的列名元数据，而实际数据库结构已更新。

解决方案 #

1. 修正模型关联声明 #

给Item的positions属性添加@Relationship注解，明确指定反向关联：

@Model public final class Item: Equatable, Identifiable {
  var form: FormModel?
  @Relationship(inverse: \Position.items) // 显式声明反向关联
  var positions = [Position]()
  var count: Int = 0
  var weight: Int = 0

  init() {}
}

多对多关系要求双方都通过@Relationship标记并指定inverse，否则SwiftData无法正确生成关联表的元数据。

2. 清理旧数据库（优先方案） #

由于已存在的数据库元数据与修正后的模型不兼容，自动迁移无法修复列名不匹配问题，需清理旧数据：

• 模拟器：删除App，或执行Product -> Clean Build Folder后重置模拟器内容。
• 真机：卸载App后重装。

3. 验证模型容器初始化 #

确保所有关联模型都被添加到ModelContainer中，避免模型遗漏导致的元数据错误：

let container = try ModelContainer(
  for: Position.self, 
  Item.self, 
  ZoneModel.self, 
  FormModel.self
)

4. 自定义迁移（如需保留数据） #

若必须保留现有数据，需定义自定义迁移计划手动修正列名，但操作复杂，步骤如下：

1. 创建迁移计划，指定旧模型版本和新模型版本。
2. 在迁移闭包中执行SQL语句，修改关联表的列名和索引：

ALTER TABLE Z_5POSITIONS RENAME COLUMN Z_7POSITIONS TO Z_6POSITIONS;
DROP INDEX IF EXISTS Z_5POSITIONS_Z_7POSITIONS_INDEX;
CREATE INDEX Z_5POSITIONS_Z_6POSITIONS_INDEX ON Z_5POSITIONS (Z_6POSITIONS, Z_5ITEMS);

注意：自定义迁移需精准匹配数据库结构，建议仅在无法清理数据时使用。

验证方法 #

1. 重新运行App，创建Position与Item的关联数据。
2. 重启App后，检查Item的positions属性是否能正常加载关联数据。
3. 查看SQLite数据库，确认关联表列名与SwiftData生成的查询语句一致。

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