SwiftUI按钮/onTapGesture丢输入及报错问题求助

问题背景 #

用SwiftUI常规Button开发游戏时，频繁出现按钮输入丢失的情况，严重影响游戏体验。快速点击时控制台会抛出报错：Failed to receive system gesture state notification before next touch，在Xcode 14.0 beta、iPhone 11设备上可稳定复现——哪怕是简单的onTapGesture也会触发该问题。试过禁用多点触控无效，用DragGesture做临时处理也没能解决报错，希望找到纯SwiftUI环境下的解决方案，不想切换到UIKit的touchesBegan实现。

测试代码（触发报错的最小示例）：

struct testView: View {
    var body: some View {
        Text("Press me!")
            .onTapGesture{/* 空实现也会报错 */}
    }
}

临时尝试的代码（未解决报错）：

@State var pressed = false

Text("Press Me")
    .gesture(DragGesture(minimumDistance: 0, coordinateSpace: .global)
        .onChanged { _ in
            if !pressed {
                // 点击逻辑
                pressed = true
            }
        }
        .onEnded { _ in pressed = false }
    )

纯SwiftUI解决方案 #

方案1：自定义高响应式按钮组件

通过自定义手势直接捕获触摸开始事件，配合状态锁避免重复触发，同时确保点击区域完整：

struct ResponsiveButton<Content: View>: View {
    let action: () -> Void
    let content: () -> Content
    
    @State private var isPressed = false
    
    var body: some View {
        content()
            .scaleEffect(isPressed ? 0.95 : 1.0) // 可选：添加按压反馈
            .gesture(
                DragGesture(minimumDistance: 0)
                    .onChanged { _ in
                        guard !isPressed else { return }
                        isPressed = true
                        action()
                    }
                    .onEnded { _ in
                        isPressed = false
                    }
            )
            .allowsHitTesting(true)
            .contentShape(Rectangle()) // 确保整个视图区域可点击
    }
}

// 使用示例
struct GameView: View {
    var body: some View {
        ResponsiveButton(action: {
            print("快速点击响应成功")
        }) {
            Text("游戏按钮")
                .padding()
                .background(Color.blue)
                .foregroundColor(.white)
                .cornerRadius(8)
        }
    }
}

这个组件绕过SwiftUI默认Button的手势识别逻辑，直接处理触摸事件，响应速度更快，不会丢失快速点击的输入。

方案2：强制手势优先级，避免系统抢占

通过including: .all让自定义手势优先于系统手势处理，减少冲突导致的输入丢失：

Text("Press me!")
    .onTapGesture {
        // 你的点击逻辑
        print("点击响应")
    }
    .gesture(TapGesture(), including: .all)

including: .all参数会让TapGesture同时参与系统和自定义手势的识别流程，避免系统手势延迟抢占触摸事件。

方案3：轻量封装UIKit按钮（SwiftUI友好调用）

如果以上方案仍不满足需求，可以封装一个极简的UIKit按钮组件，在SwiftUI中直接调用——既享受UIKit的触摸响应速度，又不用大规模重构代码：

struct UIKitButton: UIViewRepresentable {
    let title: String
    let action: () -> Void
    
    func makeUIView(context: Context) -> UIButton {
        let button = UIButton(type: .system)
        button.setTitle(title, for: .normal)
        // 使用touchDown事件，比默认的touchUpInside响应更快
        button.addTarget(context.coordinator, action: #selector(Coordinator.handleTap), for: .touchDown)
        return button
    }
    
    func updateUIView(_ uiView: UIButton, context: Context) {
        uiView.setTitle(title, for: .normal)
    }
    
    func makeCoordinator() -> Coordinator {
        Coordinator(action: action)
    }
    
    class Coordinator: NSObject {
        let action: () -> Void
        
        init(action: @escaping () -> Void) {
            self.action = action
        }
        
        @objc func handleTap() {
            action()
        }
    }
}

// 使用示例
struct GameView: View {
    var body: some View {
        UIKitButton(title: "快速点击") {
            print("UIKit按钮响应成功")
        }
    }
}

额外注意事项 #

• 确保目标视图的allowsHitTesting属性为true，避免意外禁用点击响应
• 检查视图层级中是否存在遮罩、其他手势组件抢占触摸事件
• 点击事件中避免执行耗时操作，否则会导致后续触摸事件处理延迟

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