在ListView中嵌入PDFView报错：_PlatformViewPlaceholderBox布局无限尺寸

这个问题的核心是PDFView作为平台视图组件，无法在无明确尺寸约束的滚动容器中正常渲染。ListView和SingleChildScrollView在垂直方向会传递无限高度的约束，而PDFView需要确定的尺寸范围才能完成布局。

以下是几种可行的修复方案：

方案一：基于屏幕高度设置PDFView尺寸 #

通过MediaQuery获取屏幕可用高度，减去关闭按钮和状态栏/导航栏的高度，给PDFView指定明确的高度：

ListView(
  children: [
    SizedBox(
      // 减去系统导航栏高度和关闭按钮的预留空间
      height: MediaQuery.of(context).size.height - kToolbarHeight - 60,
      child: PDFView(
        filePath: pFile.path,
      ),
    ),
    Align(
      alignment: Alignment.topRight,
      child: IconButton(
        onPressed: () {
          Navigator.of(context).pop();
        },
        icon: const Icon(Icons.close, color: Colors.black),
      ),
    ),
  ],
)

方案二：用LayoutBuilder获取父组件约束 #

通过LayoutBuilder获取父容器的可用尺寸，动态计算PDFView的高度：

LayoutBuilder(
  builder: (context, constraints) {
    return ListView(
      children: [
        SizedBox(
          // 预留关闭按钮的高度空间
          height: constraints.maxHeight - 50,
          child: PDFView(
            filePath: pFile.path,
          ),
        ),
        Align(
          alignment: Alignment.topRight,
          child: IconButton(
            onPressed: () => Navigator.of(context).pop(),
            icon: const Icon(Icons.close, color: Colors.black),
          ),
        ),
      ],
    );
  },
)

方案三：改用Column+Expanded布局 #

如果不需要ListView的滚动特性（PDFView自身通常支持滚动），可以用固定高度的容器包裹Column，让Expanded自动填充剩余空间：

Container(
  height: MediaQuery.of(context).size.height,
  child: Column(
    children: [
      Expanded(
        child: PDFView(
          filePath: pFile.path,
        ),
      ),
      Align(
        alignment: Alignment.topRight,
        child: Padding(
          padding: const EdgeInsets.symmetric(horizontal: 16, vertical: 8),
          child: IconButton(
            onPressed: () => Navigator.of(context).pop(),
            icon: const Icon(Icons.close, color: Colors.black),
          ),
        ),
      ),
    ],
  ),
)

关键说明 #

平台视图组件（如PDFView、WebView等）依赖原生视图层渲染，无法像Flutter原生组件那样自动处理无限约束。必须通过SizedBox、Expanded或LayoutBuilder等方式，给它传递明确的尺寸范围，才能避免布局断言错误。

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