@Published数组属性无法触发SwiftUI视图重绘的问题排查

问题场景 #

搭建了SwiftUI视图结构：父视图通过@StateObject初始化LeaveViewModel，视图模型包含一个@Published数组leaveRequests。但修改数组元素或追加新元素时，观察该视图模型的子视图未按预期更新。相关代码如下：

父视图 #

struct LeaveView: View {
    @StateObject private var viewModel = LeaveViewModel()

    var body: some View {
        MyRequestsView(viewModel: viewModel)
    }
}

子视图 #

struct MyRequestsView: View {
    // MARK: - Property wrappers
    @ObservedObject var viewModel: LeaveViewModel
 
    var body: some View {
        ForEach(viewModel.leaveRequests) { leave in
            NavigationLink {
                LeaveRequestDetailView(leaveRequest: leave) { request in
                    Task {
                        await viewModel.createNewLeaveRequest(with: request)
                    }
                }
            } label: {
                LeaveRequestRow(leaveRequest: leave)
            }
        }
    }
}

视图模型LeaveViewModel #

/// Properties
@Published var leaveRequests: [LeaveRequest] = [] /// Conform to Identifable

/// Methods
@MainActor
func createNewLeaveRequest(with request: LeaveRequestDTO) async {
    isLoading = true
    defer { isLoading = false }
    do {
        let leave = try await service.createNewLeaveRequest(with: request)
        leaveRequests.append(leave.data)
    } catch {
      ////
    }
}

可能的原因 #

• LeaveRequest的Identifiable协议实现存在问题
  即便注释标注遵循Identifiable，如果id属性不满足唯一且稳定的要求，ForEach无法识别元素的新增或修改。比如id使用了临时生成的值、重复值，或者元素修改时id未同步更新，都会导致ForEach无法触发对应行的渲染更新。

• 值类型/引用类型的更新逻辑错误

  • 如果LeaveRequest是结构体（struct）：修改数组内元素的内部属性时，必须替换整个数组元素（比如leaveRequests[index] = updatedRequest），直接修改属性不会触发@Published的通知——因为结构体是值类型，元素内部变化不会让数组本身的引用或结构发生改变，@Published检测不到变化。
  • 如果LeaveRequest是类（class）：数组存储的是对象引用，修改对象内部属性时，数组本身的结构或引用没有变化，@Published不会发出更新通知。这种情况需要让LeaveRequest自身继承ObservableObject，用@Published修饰内部属性，子视图单独观察每个LeaveRequest实例。

• @Published数组的更新检测机制限制
  @Published仅在数组的引用改变（如重新赋值新数组）或结构变化（如调用append、remove等修改数组长度的方法）时触发通知。如果只是修改数组中现有元素的内部状态，且未满足上述值类型/引用类型的更新要求，@Published不会感知到变化，自然不会通知视图更新。

• 主线程更新的潜在问题
  虽然createNewLeaveRequest标记了@MainActor，但如果其他修改leaveRequests的方法没有在主线程执行，也会导致视图无法及时接收到更新通知。确保所有数组修改操作都在主线程完成。

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