ScrollView与NavigationLink侧滑返回手势冲突该如何解决？

你遇到的是SwiftUI中ScrollView滚动手势和导航侧滑返回手势优先级冲突的常见问题，以下是两种可行的修复方案：

方案1：全局适配（推荐，无需修改业务页面代码） #

通过扩展UINavigationController调整手势识别规则，允许系统侧滑手势和ScrollView滚动手势同时识别，全项目通用：

extension UINavigationController: UIGestureRecognizerDelegate {
    override open func viewDidLoad() {
        super.viewDidLoad()
        // 将系统侧滑返回手势的代理设为当前导航控制器
        interactivePopGestureRecognizer?.delegate = self
    }

    public func gestureRecognizer(_ gestureRecognizer: UIGestureRecognizer, shouldRecognizeSimultaneouslyWith otherGestureRecognizer: UIGestureRecognizer) -> Bool {
        // 仅对系统侧滑返回手势开启同时识别权限
        return gestureRecognizer is UIScreenEdgePanGestureRecognizer
    }

    public func gestureRecognizerShouldBegin(_ gestureRecognizer: UIGestureRecognizer) -> Bool {
        // 导航栈只有根页面时禁止侧滑返回，避免异常
        return viewControllers.count > 1
    }
}

添加这段代码后，所有页面的侧滑返回和ScrollView滚动都会正常工作，不会互相干扰。

方案2：单独页面适配 #

如果只需要修复单个页面的冲突，可以直接在对应页面的ScrollView上添加手势修饰：

struct AnotherView: View {
    var body: some View {
        ScrollView {
            LazyVStack(alignment: .leading) {
                // ... 联系人列表内容
            }
        }
        .simultaneousGesture(
            DragGesture(minimumDistance: 0)
                .onChanged { value in
                    // 左边缘15pt范围内的水平滑动优先响应侧滑返回
                    if value.startLocation.x < 15 && abs(value.translation.width) > abs(value.translation.height) {
                        // 取消ScrollView的滚动响应
                        UIApplication.shared.sendAction(#selector(UIResponder.resignFirstResponder), to: nil, from: nil, for: nil)
                    }
                }
        )
    }
}

注意事项 #

• 两种方案均适配NavigationView和SwiftUI 4+的NavigationStack
• 不要直接禁用ScrollView的滚动手势，避免垂直滚动功能异常
• 侧滑返回的触发范围默认是屏幕左边缘20pt以内，不需要调整这个阈值避免误触

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