Flutter集成popover插件报错：type 'RenderSliverList' is not a subtype of type 'RenderBox'

架构老林

2026-9-30

问题原因

报错核心是Sliver系列滚动容器（如CustomScrollView、SliverList、SliverGrid等）的渲染对象类型为RenderSliver，和普通组件使用的RenderBox不属于同一继承链，无法直接强转。
你触发popover的组件位于Sliver类容器内，插件默认调用context.findRenderObject()时获取到了上层Sliver容器的RenderSliver实例，强转为RenderBox就会抛出类型不匹配错误。
少数情况是你传入showPopover方法的context不是触发组件自身的context，而是上层Sliver容器的context。

修复方案

方案1：使用Builder获取触发组件的专属context

给触发popover的组件外层包裹Builder组件，强制获取组件自身的context，避免拿到上层Sliver容器的context，示例代码：

SliverList(
  delegate: SliverChildBuilderDelegate((context, index) {
    // 外层加Builder，拿到按钮自身的context
    return Builder(
      builder: (buttonContext) {
        return TextButton(
          onPressed: () {
            // 传入Builder返回的context
            showPopover(
              context: buttonContext,
              body: const Text('弹窗内容'),
            );
          },
          child: const Text('触发弹窗'),
        );
      },
    );
  }),
)

方案2：修改插件的RenderBox获取逻辑

如果方案1无效，可手动修改插件中报错的代码段，遍历渲染对象树直到找到RenderBox实例：
把原报错行final box = widget.context.findRenderObject() as RenderBox;替换为如下代码：

RenderBox? box;
RenderObject? currentRender = widget.context.findRenderObject();
// 遍历父级渲染对象直到找到RenderBox
while (currentRender != null) {
  if (currentRender is RenderBox) {
    box = currentRender;
    break;
  }
  currentRender = currentRender.parent as RenderObject?;
}
// 增加判空逻辑避免空异常
if (box == null) return;