SwiftUI数据库列表无法选中项，数组列表正常，求问题排查

问题现象 #

使用SwiftData作为数据源的列表无法选中任何项，但使用普通字符串数组的列表可正常选中。控制台输出以下日志：

Can't find or decode reasons
Failed to get or decode unavailable reasons
NSBundle file:///System/Library/PrivateFrameworks/MetalTools.framework/ principal class is nil because all fallbacks have failed

失效代码（SwiftData数据源） #

import SwiftUI
import SwiftData

struct ItemView: View {
    
    @Environment(\.modelContext) private var context
    @Query(sort: \Item.title) private var items: [Item]
    
    @State private var selection: String? = nil
    
    var body: some View {
        if items.isEmpty {
            ContentUnavailableView("Enter your first item.", systemImage: "bookmark.fill")
        } else {
            List(items, id: \.self, selection: $selection) { item in
                Text(item.title)
            }
        }
    }
}

正常代码（普通数组数据源） #

import SwiftUI

struct ContentView: View {
    @State private var selection: String?
    @State private var isOn: Bool = false
    
    let names = [
        "Cyril",
        "Lana",
        "Mallory",
        "Sterling"
    ]

    var body: some View {
        NavigationStack {
            List(names, id: \.self, selection: $selection) { name in
                Toggle(isOn: $isOn) {
                    Text(name)
                }
            }
            .navigationTitle("List Selection")
            .toolbar {
                
            }
        }
    }
}

问题原因及修复方案 #

1. 缺少导航容器（NavigationStack） #

SwiftUI的列表选中功能依赖导航环境，必须将列表包裹在NavigationStack（iOS16及以上）或NavigationView（iOS15及以下）内才能启用选中交互。失效代码未添加导航容器，而正常代码在NavigationStack中。

2. 选择类型与数据源不匹配 #

你定义的selection为String?，但SwiftData的Item是引用类型，用\.self作为id时，选中对象的类型应为Item?而非String?。如果Item模型有自定义字符串类型的唯一id（比如@Attribute(.unique) var id: String），可将selection改为String?，并把列表的id设为\.id。

3. SwiftData模型的哈希稳定性问题 #

默认SwiftData模型自动遵循Hashable，但基于引用的哈希值可能不稳定。建议显式让Item遵循Hashable，或者使用模型的稳定标识符作为列表id：

List(items, id: \.persistentModelID, selection: $selection) { item in
    Text(item.title)
}

此时selection的类型需改为PersistentIdentifier?。

修复后的示例代码 #

import SwiftUI
import SwiftData

struct ItemView: View {
    
    @Environment(\.modelContext) private var context
    @Query(sort: \Item.title) private var items: [Item]
    
    // 改为匹配数据源的Item类型可选值
    @State private var selection: Item? = nil
    
    var body: some View {
        NavigationStack { // 添加导航容器
            if items.isEmpty {
                ContentUnavailableView("Enter your first item.", systemImage: "bookmark.fill")
            } else {
                List(items, id: \.self, selection: $selection) { item in
                    Text(item.title)
                }
                .navigationTitle("Items") // 添加导航标题确保环境正常
            }
        }
    }
}

关于控制台日志 #

你看到的MetalTools相关日志属于系统级警告，和列表选中问题无关，可忽略，不影响功能。

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