添加@Query宏后子视图无法渲染疑似无限循环问题排查

以下是针对你遇到的问题的排查和解决方案：

1. 用常量过滤条件初始化@Query #

子视图直接使用父传Album的动态属性做过滤，可能因Album的Observable特性触发查询频繁重执行，导致视图循环重绘。建议初始化时提取常量ID构建Predicate：

struct PersistentAlbumView: View {
    let album: Album
    @Query private var media: [Media]
    
    init(album: Album) {
        self.album = album
        // 提取常量ID，避免依赖Observable对象的动态属性
        let targetAlbumID = album.id
        _media = Query(filter: #Predicate<Media> { $0.album.id == targetAlbumID })
    }
    
    var body: some View {
        VStack {
            Text("当前相册ID: \(album.id.uuidString)")
            Text("媒体数量: \(media.count)")
        }
        .onAppear {
            print("视图加载，查询到媒体数: \(media.count)")
            // 打印查询结果验证过滤逻辑
            media.forEach { print("媒体关联相册ID: \($0.album?.id?.uuidString ?? "无")") }
        }
    }
}

2. 手动传递ModelContext避免上下文不匹配 #

导航进入子视图时，可能存在SwiftData自动上下文传递失效的情况，手动传入父视图的ModelContext可确保查询使用同一上下文：

父视图导航代码： #

struct AlbumListView: View {
    @Environment(\.modelContext) private var modelContext
    @Query private var albums: [Album]
    
    var body: some View {
        List(albums) { album in
            NavigationLink(
                destination: PersistentAlbumView(album: album, modelContext: modelContext)
            ) {
                Text(album.name)
            }
        }
    }
}

子视图修改： #

struct PersistentAlbumView: View {
    let album: Album
    let modelContext: ModelContext
    @Query private var media: [Media]
    
    init(album: Album, modelContext: ModelContext) {
        self.album = album
        self.modelContext = modelContext
        let targetAlbumID = album.id
        // 显式指定查询上下文
        _media = Query(
            filter: #Predicate<Media> { $0.album.id == targetAlbumID },
            context: modelContext
        )
    }
    
    // body代码同上
}

3. 验证数据模型关联定义 #

即使不直接使用album.media，仍需确保Media与Album的关联定义正确，否则过滤条件会失效：

@Model
class Album {
    var id: UUID = UUID()
    var name: String
    // 正确定义逆关系
    @Relationship(deleteRule: .cascade, inverse: \Media.album) 
    var media: [Media] = []
    
    init(name: String) {
        self.name = name
    }
}

@Model
class Media {
    var id: UUID = UUID()
    var url: URL
    // 确保关联属性类型正确
    var album: Album?
    
    init(url: URL, album: Album?) {
        self.url = url
        self.album = album
    }
}

4. 排查查询结果是否为空 #

在.onAppear中打印media数组内容，确认是否因过滤条件不匹配导致结果为空，进而让视图看起来"未渲染"。如果预览正常但真机/模拟器查询为空，可能是预览测试数据与实际持久化数据不一致。

5. 检查是否存在循环重绘 #

添加.onChange监听media数组变化，查看是否存在无限触发的情况：

.onChange(of: media) { newValue in
    print("媒体数组变化: \(newValue.count)")
}

如果日志频繁输出该信息，说明存在循环重绘，需检查是否有其他视图属性触发了@Query的重新执行。

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