SwiftUI @State属性变更的XCTest测试失败问题求解

你遇到的问题核心在于**@State属性的管理机制**：@State是SwiftUI框架专属的状态包装器，它的存储由SwiftUI运行时负责，而非视图结构体本身。直接实例化ToggleView并修改toggle变量时，并没有触发SwiftUI的状态更新流程，因此变量值不会按预期同步更新，导致断言失败。

推荐两种可行的测试方案，按需选择：

方案1：提取状态逻辑到ViewModel（推荐） #

将状态和业务逻辑从视图中分离到ObservableObject类型的ViewModel中，这样可以脱离SwiftUI视图生命周期直接测试逻辑，更稳定可靠。

修改后的视图代码 #

import SwiftUI

class ToggleViewModel: ObservableObject {
    @Published var isToggled: Bool = false
    
    func handleToggleAction() {
        isToggled = true
    }
}

struct ToggleView: View {
    @StateObject private var viewModel = ToggleViewModel()
    
    var body: some View {
        Button("Toggle") {
            viewModel.handleToggleAction()
        }
    }
}

对应的测试代码 #

import XCTest
@testable import YourAppName

final class ToggleTests: XCTestCase {
    func testToggleAction() {
        // Given
        let viewModel = ToggleViewModel()
        XCTAssertFalse(viewModel.isToggled)
        
        // When
        viewModel.handleToggleAction()
        
        // Then
        XCTAssertTrue(viewModel.isToggled)
    }
}

这种方法完全避开了SwiftUI的异步状态更新问题，测试逻辑直接、可靠，也是SwiftUI项目中常用的测试策略。

方案2：直接测试视图（需处理异步更新） #

如果必须直接测试视图本身的交互，需要借助SwiftUI的视图托管机制，并等待状态更新完成：

import XCTest
import SwiftUI
@testable import YourAppName

final class ToggleTests: XCTestCase {
    func testToggleViewStateUpdate() async {
        // Given
        let view = ToggleView()
        // 使用UIHostingController托管视图，触发SwiftUI运行时初始化
        let hostingController = UIHostingController(rootView: view)
        _ = hostingController.view // 加载视图，初始化@State存储
        
        // 初始状态断言
        XCTAssertFalse(view.toggle)
        
        // When
        view.handleToggleAction()
        // 等待SwiftUI完成状态更新（异步操作）
        await Task.yield()
        
        // Then
        XCTAssertTrue(view.toggle)
    }
}

注意：这种方法依赖SwiftUI的内部运行时行为，稳定性不如测试ViewModel。如果视图逻辑复杂，建议优先选择方案1。

• @State变量的访问被包装器拦截，只有当视图被SwiftUI托管时（比如通过UIHostingController或在App中渲染），其底层存储才会被正确初始化，直接修改结构体实例的@State变量不会生效。
• 对于SwiftUI视图的交互测试（比如按钮点击），更完整的方案是使用UI测试（XCUI），模拟用户真实操作并验证界面变化，但单元测试阶段优先测试ViewModel逻辑效率更高。

内容的提问来源于stack exchange，提问作者Santiago Carmona González