Swift Widget视图状态变更后未更新问题求助

问题描述 #

尝试在Widget中异步获取URL并渲染，但URL获取完成后视图始终未刷新。已验证willSet方法被调用且URL生成正确，相关代码如下：

@MainActor
class MapUrlModel: ObservableObject {
    @Published public var url: String? {
        willSet {
            self.objectWillChange.send()
            print("changed")
        }
    }

    init() {}

    func load(
        ampm: String,
        date: String,
        publicationTime: String,
        region: String
    ) async throws {
        self.url = await getMapImage(
            ampm: ampm,
            date: date,
            publicationTime: publicationTime,
            region: region
        )
    }
}

struct MapWidgetView: View {
    @Environment(\.widgetFamily) var family
    // I also tried with @StateObject
    @ObservedObject private var mapUrlModel = MapUrlModel()

    let entry: MapWidgetTimelineEntry
    let locationDetail: LocationDetail?
    let bulletins: [ContextualBulletin]
    let bestMatchingBulletin: ContextualBulletin?
    let background: String
    let reportDate: String?
    var reportMapUrl: String?
    
    init(entry: MapWidgetTimelineEntry) {
        self.entry = entry
        self.locationDetail = entry.locationDetail
        self.bulletins = entry.bulletins
        self.bestMatchingBulletin = entry.bulletins.first(where: {
            $0.locationMatching
        })
        self.background = entry.background.id
        self.reportDate = entry.reportDate
    }
    
    var body: some View {
        VStack {
            Text("Map")
            if self.mapUrlModel.url != nil {
                Text("Here")
                AsyncImage(url: URL(string: self.mapUrlModel.url!))
            } else {
                Text(self.mapUrlModel.url ?? "fallback")
            }
        }.onAppear {
            if (self.bestMatchingBulletin != nil && self.reportDate != nil) {
                let publicationTime = self.bestMatchingBulletin!.data.metaDataProperty.MetaData.dateTimeReport
                let region = self.bestMatchingBulletin!.data.gml_id
                
                Task { [self] in
                    do {
                        try await mapUrlModel.load(
                            ampm: "am",
                            date: String(entry.reportDate!.split(separator: "T").first!),
                            publicationTime: publicationTime,
                            region: region
                        )
                    } catch {
                        print(error)
                    }
                }
            }
        }.onChange(of: mapUrlModel.url) {
            print("Henlo")
        }.environmentObject(mapUrlModel)
        .containerBackground(for: .widget) {}
    }
}

问题原因 #

1. 手动干扰@Published通知逻辑：@Published属性会自动发送变更通知，手动调用objectWillChange.send()会破坏内部通知流程，导致视图无法正确响应更新。
2. Widget生命周期限制：Widget的视图生命周期与普通App不同，onAppear触发时机不可靠，且系统会限制视图内的异步操作，即使数据更新也可能无法触发视图刷新。
3. 错误使用对象绑定注解：@ObservedObject不适合Widget视图管理ObservableObject，应该用@StateObject确保对象与视图生命周期绑定。

解决方案 #

1. 移除手动通知调用 #

删除willSet中的objectWillChange.send()，保留@Published的自动通知功能：

@MainActor
class MapUrlModel: ObservableObject {
    @Published public var url: String?

    init() {}

    func load(
        ampm: String,
        date: String,
        publicationTime: String,
        region: String
    ) async throws {
        self.url = await getMapImage(
            ampm: ampm,
            date: date,
            publicationTime: publicationTime,
            region: region
        )
    }
}

2. 替换为@StateObject #

确保ObservableObject与Widget视图生命周期绑定：

@StateObject private var mapUrlModel = MapUrlModel()

3. 优先通过TimelineProvider提供数据（推荐） #

Widget的设计逻辑是由TimelineProvider管理数据更新，而非视图内异步加载：

• 在MapWidgetTimelineEntry中添加mapUrl属性
• 在TimelineProvider的getTimeline方法中异步获取URL，生成包含该URL的Entry
• 视图直接使用entry.mapUrl渲染，无需ObservableObject

这种方式符合Widget的生命周期规则，能确保视图在数据更新时正确刷新。

总结 #

避免手动管理objectWillChange通知，使用@StateObject绑定对象生命周期，同时优先通过TimelineProvider处理数据加载，是解决Widget视图不刷新问题的核心方案。

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