容器内无法查看PDF文件，出现RenderConstrainedOverflowBox错误

问题根源 #

你遇到的RenderConstrainedOverflowBox object was given an infinite size during layout错误，核心是布局约束冲突：

• 外层SingleChildScrollView会给子节点提供无限垂直空间
• 嵌套的ListView即便设置shrinkWrap: true，也无法给SfPdfViewer传递有效尺寸约束
• SfPdfViewer本身需要明确的宽高限制才能正常渲染

修复方案 #

简化布局层级，给SfPdfViewer提供明确尺寸约束，同时因为你用了limit(1)，完全不需要ListView包裹单个PDF：

class MyFile extends StatefulWidget {
  const MyFile({super.key});

  @override
  State<MyFile> createState() => _MyFileState();
}

class _MyFileState extends State<MyFile> {
  User? user = FirebaseAuth.instance.currentUser;
  final PdfViewerController pdfViewerController = PdfViewerController();

  @override
  Widget build(BuildContext context) {
    // 处理用户未登录场景
    if (user == null) {
      return const Scaffold(body: Center(child: Text("请先登录")));
    }

    return Scaffold(
      body: StreamBuilder<QuerySnapshot>(
        stream: FirebaseFirestore.instance
            .collection('cartesP')
            .where('userId', isEqualTo: user!.uid)
            .limit(1)
            .snapshots(),
        builder: (context, snapshot) {
          if (snapshot.connectionState == ConnectionState.waiting) {
            return const Center(child: CircularProgressIndicator());
          }
          if (!snapshot.hasData || snapshot.data!.docs.isEmpty) {
            return const Center(child: Text("未找到PDF文件"));
          }

          // 直接获取唯一文档
          final doc = snapshot.data!.docs.first;
          final pdfUrl = doc['fileUrl'];

          // 用Expanded让PDFViewer占满可用空间，也可替换为固定高度Container
          return Expanded(
            child: SfPdfViewer.network(
              pdfUrl,
              controller: pdfViewerController,
            ),
          );
        },
      ),
    );
  }
}

关键修改点 #

1. 移除冗余滚动组件：SfPdfViewer自带滚动功能，无需外层SingleChildScrollView和ListView
2. 明确尺寸约束：用Expanded让PDFViewer占满父级可用空间，或固定高度（如height: MediaQuery.of(context).size.height * 0.8）
3. 简化数据处理：因limit(1)直接取第一个文档，避免不必要的列表渲染
4. 补充异常处理：增加用户未登录、无数据的场景，避免空指针异常

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