Flutter Overlay问题：检测下层点击且不阻断事件传递

1. Overlay未定位导致全屏覆盖：你添加的OverlayEntry没有使用定位组件，内部的RawGestureDetector默认占满整个Overlay层，覆盖了页面所有内容，所有点击事件都会先经过这个手势识别器。
2. 自定义手势识别器强制拦截事件：AllowMultipleTap重写了rejectGesture并直接调用acceptGesture，导致该识别器永远不会放弃手势竞争，一旦检测到点击就会拦截事件，下层按钮（包括返回按钮）的回调因此无法触发。

方案一：用Listener代替RawGestureDetector（推荐） #

Listener监听原始指针事件，不参与手势竞争，既能检测点击，又不会阻断事件向下传递。同时给Overlay内容添加定位，避免不必要的区域覆盖：

修改WithOverlay中的OverlayEntry代码：

final entry = OverlayEntry(
  builder: (context) {
    // 用Positioned定位Overlay内容，限制检测区域
    return Positioned(
      top: 100,
      left: 100,
      child: Listener(
        // 监听指针抬起事件，实现点击检测
        onPointerUp: (event) => print('tap detected'),
        child: Container(
          width: 100,
          height: 100,
          alignment: Alignment.centerLeft,
          child: ElevatedButton(
            onPressed: _incrementCounter,
            child: const Text("add one"),
          ),
        ),
      ),
    );
  },
);

方案二：修复RawGestureDetector和自定义识别器（保留手势识别逻辑） #

如果需要保留RawGestureDetector的手势识别能力，需做两处修改：

1. 给Overlay内容添加定位，缩小检测范围；
2. 调整自定义手势识别器的逻辑，取消强制拦截：

// 调整自定义手势识别器，恢复默认的拒绝逻辑
class AllowMultipleTap extends TapGestureRecognizer {
  @override
  void rejectGesture(int pointer) {
    super.rejectGesture(pointer);
  }
}

// 修改OverlayEntry的builder，添加定位
final entry = OverlayEntry(
  builder: (context) {
    return Positioned(
      top: 100,
      left: 100,
      child: RawGestureDetector(
        behavior: HitTestBehavior.translucent,
        gestures: {
          AllowMultipleTap: GestureRecognizerFactoryWithHandlers<AllowMultipleTap>(
            () => AllowMultipleTap(),
            (AllowMultipleTap instance) {
              instance.onTap = () => print('tap detected');
            },
          )
        },
        child: Container(
          width: 100,
          height: 100,
          alignment: Alignment.centerLeft,
          child: ElevatedButton(
            onPressed: _incrementCounter,
            child: const Text("add one"),
          ),
        ),
      ),
    );
  },
);

额外说明 #

如果需要在Overlay覆盖区域内，让下层按钮和Overlay的检测同时触发，方案一的Listener是最佳选择——它不会参与手势竞争，事件会完整传递给下层组件。方案二的手势识别器会和下层组件竞争手势，无法保证两者同时响应。

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