SwiftUI Popover真机下被键盘遮挡锚点后自动消失问题求助

问题概述 #

使用iOS 16.4新增的紧凑版Popover编辑列表项值时，满足以下条件会触发真机专属异常：

• 列表项直接显示被编辑的值
• 被修改的列表项完全被弹出的键盘遮挡
• 预览和模拟器无此问题，仅真机触发

复现步骤：

1. 点击列表末尾项打开Popover，修改TextField值后关闭Popover
2. 再次点击同一列表项打开Popover，点击TextField时Popover自动关闭

问题根源 #

这是SwiftUI与UIKit桥接层的布局冲突导致：当列表项被键盘遮挡时，修改值会触发列表项视图重绘（文本更新），此时真机的UIKit布局系统会重新计算锚点视图（触发Popover的Button）的位置，误判锚点视图已不在可视区域或布局失效，进而自动关闭Popover。

解决方案 #

方案1：稳定锚点视图的布局 #

给触发Popover的Button添加固定尺寸，切断值更新与锚点布局变化的关联，避免因文本长度变化导致布局偏移：

struct ItemWithPopover: View {
    @State var show = false
    @State var value: Int = 0
    
    var body: some View {
        Button("button (\(value))") {
            show = true
        }
        .padding()
        .frame(width: 200, height: 50) // 固定尺寸稳定布局
        .popover(isPresented: $show) {
            PopoverContent(value: $value)
                .presentationCompactAdaptation(.popover)
        }
    }
}

方案2：使用popover(item:)替代isPresented #

通过绑定可选的可识别对象控制Popover展示，比布尔值isPresented更稳定，减少布局变化带来的误触发：

// 定义可识别的状态对象
struct PopoverState: Identifiable {
    let id = UUID()
    var value: Int
}

struct ItemWithPopover: View {
    @State var popoverState: PopoverState? = nil
    @State var value: Int = 0
    
    var body: some View {
        Button("button (\(value))") {
            popoverState = PopoverState(value: value)
        }
        .padding()
        .popover(item: $popoverState) { state in
            PopoverContent(value: $value)
                .presentationCompactAdaptation(.popover)
        }
    }
}

方案3：固定Popover的锚点位置 #

通过attachmentAnchor参数指定Popover的锚点为固定位置，避免锚点随列表布局变化：

struct ItemWithPopover: View {
    @State var show = false
    @State var value: Int = 0
    
    var body: some View {
        Button("button (\(value))") {
            show = true
        }
        .padding()
        .popover(
            isPresented: $show,
            attachmentAnchor: .point(.top), // 固定锚点为视图顶部
            content: {
                PopoverContent(value: $value)
                    .presentationCompactAdaptation(.popover)
            }
        )
    }
}

额外问题处理：关闭键盘时Popover意外关闭 #

针对使用resignFirstResponder关闭键盘时，锚点被遮挡导致Popover同时关闭的问题，建议使用SwiftUI原生的@FocusState管理TextField焦点，替代直接调用UIKit方法，更贴合SwiftUI状态管理逻辑：

struct PopoverContent: View {
    @Binding var value: Int
    @FocusState private var isTextFieldFocused: Bool // 管理焦点状态
    
    var body: some View {
        HStack {
            Text("Value: ")
            TextField("Value", value: $value, formatter: NumberFormatter())
                .keyboardType(.numberPad)
                .focused($isTextFieldFocused)
        }
        .frame(minWidth: 350)
        .padding()
        .onTapGesture {
            isTextFieldFocused = false // 点击外部关闭焦点（键盘）
        }
    }
}

这种方式关闭键盘时，不会触发UIKit层面的布局误判，避免Popover被意外关闭。

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