tvOS 17.2中SwiftUI TabView（.page样式）$selection自动复位问题

这是tvOS 17.2引入的系统bug：当使用.page样式的TabView时，初始设置的selection会被自动重置为第一个标签页，仅在模拟器/真机上触发，预览和旧版本系统（tvOS 16.x/17.0）无此问题。

以下是几种可行的修复/临时解决办法：

方法1：延迟设置目标选中项 #

利用onAppear配合延迟任务，避开系统的重置逻辑，这是最简单的解决方案：

import SwiftUI

@available(tvOS 17.2, *)
struct TestTabView: View {
    @State private var selectedTabIndex = 0 // 初始设为默认值
    private let targetTab = 5 // 目标标签索引
    
    var body: some View {
        TabView(selection: $selectedTabIndex) {
            ForEach(1...20, id: \.self) { i in
                Text("Tab: \(i)")
                    .tag(i)
            }
        }
        .tabViewStyle(.page)
        .onAppear {
            // 延迟0.1秒设置目标索引，避开系统重置时机
            DispatchQueue.main.asyncAfter(deadline: .now() + 0.1) {
                selectedTabIndex = targetTab
            }
        }
    }
}

方法2：监听选中项变化并强制修正 #

通过onReceive实时监听selection的变化，当被系统强制重置为第一个标签时，自动改回目标值：

import SwiftUI

@available(tvOS 17.2, *)
struct TestTabView: View {
    @State private var selectedTabIndex = 5
    private let targetTab = 5
    
    var body: some View {
        TabView(selection: $selectedTabIndex) {
            ForEach(1...20, id: \.self) { i in
                Text("Tab: \(i)")
                    .tag(i)
            }
        }
        .tabViewStyle(.page)
        .onReceive($selectedTabIndex) { newValue in
            // 当系统将选中项重置为第一个标签（此处为1）时，强制恢复目标值
            if newValue == 1 && selectedTabIndex != targetTab {
                selectedTabIndex = targetTab
            }
        }
    }
}

方法3：封装UIKit的UIPageViewController（适合大量页面场景） #

如果你的应用有100-200个标签页，直接使用UIKit的UIPageViewController封装成SwiftUI视图，彻底绕过SwiftUI的bug，同时性能更可控：

import SwiftUI
import UIKit

struct PageView<Content: View>: UIViewControllerRepresentable {
    let content: [Content]
    @Binding var selectedIndex: Int
    
    func makeUIViewController(context: Context) -> UIPageViewController {
        let pageVC = UIPageViewController(transitionStyle: .scroll, navigationOrientation: .horizontal)
        pageVC.dataSource = context.coordinator
        pageVC.delegate = context.coordinator
        
        // 设置初始显示页面
        if let initialVC = context.coordinator.viewController(at: selectedIndex) {
            pageVC.setViewControllers([initialVC], direction: .forward, animated: false)
        }
        return pageVC
    }
    
    func updateUIViewController(_ pageVC: UIPageViewController, context: Context) {
        // 当选中索引变化时同步页面
        guard let currentVC = pageVC.viewControllers?.first,
              let currentIndex = context.coordinator.index(for: currentVC),
              currentIndex != selectedIndex else { return }
        
        let direction: UIPageViewController.NavigationDirection = selectedIndex > currentIndex ? .forward : .reverse
        if let targetVC = context.coordinator.viewController(at: selectedIndex) {
            pageVC.setViewControllers([targetVC], direction: direction, animated: true)
        }
    }
    
    func makeCoordinator() -> Coordinator {
        Coordinator(parent: self)
    }
    
    class Coordinator: NSObject, UIPageViewControllerDataSource, UIPageViewControllerDelegate {
        let parent: PageView
        
        init(parent: PageView) {
            self.parent = parent
        }
        
        func viewController(at index: Int) -> UIViewController? {
            guard index >= 0 && index < parent.content.count else { return nil }
            return UIHostingController(rootView: parent.content[index])
        }
        
        func index(for viewController: UIViewController) -> Int? {
            guard let hostingVC = viewController as? UIHostingController<Content>,
                  let index = parent.content.firstIndex(where: { hostingVC.rootView.id == $0.id }) else {
                return nil
            }
            return index
        }
        
        // 实现UIPageViewControllerDataSource协议
        func pageViewController(_ pageViewController: UIPageViewController, viewControllerBefore viewController: UIViewController) -> UIViewController? {
            guard let index = index(for: viewController), index > 0 else { return nil }
            return viewController(at: index - 1)
        }
        
        func pageViewController(_ pageViewController: UIPageViewController, viewControllerAfter viewController: UIViewController) -> UIViewController? {
            guard let index = index(for: viewController), index < parent.content.count - 1 else { return nil }
            return viewController(at: index + 1)
        }
        
        // 监听页面切换完成，同步选中索引
        func pageViewController(_ pageViewController: UIPageViewController, didFinishAnimating finished: Bool, previousViewControllers: [UIViewController], transitionCompleted completed: Bool) {
            guard completed, let currentVC = pageViewController.viewControllers?.first, let index = index(for: currentVC) else { return }
            parent.selectedIndex = index
        }
    }
}

// 使用示例
@available(tvOS 17.2, *)
struct FixedTestTabView: View {
    @State private var selectedTabIndex = 5
    
    var body: some View {
        PageView(
            content: (1...20).map { i in
                Text("Tab: \(i)")
                    .id(i) // 必须添加id用于视图识别
            },
            selectedIndex: $selectedTabIndex
        )
    }
}

各方法适用场景 #

• 方法1：快速解决，适合大多数中小规模页面场景
• 方法2：适合需要防止选中项被意外修改的场景
• 方法3：适合大量页面（100+）的场景，性能更稳定，彻底规避SwiftUI的bug

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