Flutter：如何在OverlayEntry的Builder方法中实现浮层移除？

这个场景不需要额外传参、遍历路由栈，直接利用Dart的闭包作用域特性，就能在builder内部拿到当前的OverlayEntry实例完成移除操作。
很多开发者会陷入认知误区：以为OverlayEntry的builder会在构造函数执行时立刻运行，此时overlayEntry实例还没完成初始化，会出现变量引用错误。但实际上Flutter中的builder是懒执行的——只有当Overlay将条目插入渲染树、需要构建展示内容时，才会触发builder回调，这时候外层作用域的overlayEntry变量已经完全初始化完成，完全可以在内部的点击回调中直接调用remove()方法。 #

showOverLay(BuildContext context, Widget child,
    [double top, double bottom, double right, double left]) {
  OverlayState overlayState = Overlay.of(context);
  // 用late修饰变量，消除静态分析提示的“引用未赋值变量”警告
  late final OverlayEntry overlayEntry;

  overlayEntry = OverlayEntry(
    builder: (context) {
      return Material(
        color: Colors.transparent,
        child: GestureDetector(
          onTap: () {
            // 直接引用外层作用域的overlayEntry实例执行移除
            overlayEntry.remove();
            // 此处可补充移除触发后的自定义业务逻辑
          },
          child: Positioned(
            top: top,
            bottom: bottom,
            right: right,
            left: left,
            child: GestureDetector(
              onTap: () {
                // 内层组件的点击逻辑如需移除，同样可以直接调用
                // overlayEntry.remove();
              },
              child: child,
            ),
          ),
        ),
      );
    },
  );

  overlayState.insert(overlayEntry);
}

• 不要在builder的作用域内重新声明同名的overlayEntry变量，否则会覆盖外层可被闭包捕获的实例引用，导致移除逻辑失效
• 如果需要避免用户连续点击触发重复移除报错，可以提前定义布尔值标记位，在首次触发移除后置为true，后续点击时直接跳过移除逻辑
• 不需要额外遍历Overlay.of(context).entries匹配当前条目，闭包直接引用的实例是最精准的，不会出现条目匹配错位的问题

额外实操提示：如果需要支持Overlay内容动态更新、点击空白区域关闭等能力，同样可以在这个闭包作用域内拿到overlayEntry实例，调用markNeedsBuild()刷新界面、或者复用remove()方法完成关闭操作。

内容的提问来源于stack exchange，提问作者Amr M.