快速点击SwiftUI按钮出现Failed to receive system gesture报错如何解决

• 这个报错是SwiftUI默认的Button和onTapGesture内置了手势冲突检测逻辑，会额外等待一小段时间判断当前输入是点击、滑动还是长按等其他手势，高频多手指点击时，下一次触摸输入在系统完成上一个手势状态同步前就到达，就会触发该报错，同时丢弃本次点击事件。
• 不是SwiftUI不支持高频输入场景，是默认的高级手势封装不适合这种低延迟、高响应的点击需求。

方案1：使用UIKit桥接自定义触摸响应（性能最优） #

直接通过UIViewRepresentable桥接UIKit视图，重写原生触摸响应方法，完全绕过SwiftUI的手势识别栈，延迟最低，适配高频多手指点击场景：

import SwiftUI

struct FastTapView: UIViewRepresentable {
    let onTap: () -> Void
    
    func makeUIView(context: Context) -> UIView {
        let view = UIView()
        view.isMultipleTouchEnabled = true // 支持多手指点击
        let tapRecognizer = UITapGestureRecognizer(target: context.coordinator, action: #selector(Coordinator.handleTap))
        tapRecognizer.delaysTouchesBegan = false
        tapRecognizer.delaysTouchesEnded = false
        tapRecognizer.cancelsTouchesInView = false
        view.addGestureRecognizer(tapRecognizer)
        return view
    }
    
    func updateUIView(_ uiView: UIView, context: Context) {}
    
    func makeCoordinator() -> Coordinator {
        Coordinator(onTap: onTap)
    }
    
    class Coordinator: NSObject {
        let onTap: () -> Void
        init(onTap: @escaping () -> Void) {
            self.onTap = onTap
        }
        
        @objc func handleTap() {
            onTap()
        }
    }
}

// 使用示例
struct ContentView: View {
    var body: some View {
        FastTapView(onTap: handleTap)
            .frame(width: 200, height: 100)
            .overlay {
                Text("Press me!")
            }
    }
    
    func handleTap() {
        // 你的点击逻辑
    }
}

方案2：使用SwiftUI DragGesture替代（纯SwiftUI实现） #

如果不想引入UIKit桥接，可以把onTapGesture替换为DragGesture，设置最小滑动距离为0，让手势在触摸按下时就触发，跳过系统的点击判断延迟：

Text("Press me!")
    .frame(width: 200, height: 100)
    .contentShape(Rectangle())
    .highPriorityGesture(
        DragGesture(minimumDistance: 0)
            .onEnded { _ in
                handleTap()
            }
    )

• 不需要系统的点击反馈的话，可以给按钮加.buttonStyle(.plain)关闭内置的点击动画和延迟
• 确保视图的allowsHitTesting为true，没有被上层视图拦截触摸事件
• 如果同时存在其他手势，优先用highPriorityGesture修饰你的点击手势，提高响应优先级

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