Flutter pdf包MultiPage组件动态添加页面触发异常问题

问题重现 #

使用pdf包的MultiPage组件生成PDF时，少量内容能正常生成1-2页，但内容增加后无法生成第3页，反而抛出异常：

Exception (Exception: This widget created more than 50 pages. This may be an issue in the widget or the document.)

核心原因 #

你把所有内容嵌套在单个pw.Column中返回给MultiPage，而Column是不可分页的容器。MultiPage无法拆分这个Column的内容，当Column整体超过一页容量时，组件会不断尝试新建页面但始终无法容纳完整的Column，最终触发maxPages上限的异常。

解决方案 #

1. 移除外层嵌套的Column
   MultiPage的build方法直接返回组件列表即可，不需要用Column包裹。MultiPage会自动处理列表中每个组件的分页逻辑：

   Future<void> generate() async {
     final logo = await _logo();
     final pdf = pw.Document();
     pdf.addPage(pw.MultiPage(
       pageFormat: PdfPageFormat.a4,
       maxPages: 50,
       build: (pw.Context context) {
         return [
           // 直接返回各个组件，无需外层Column
           pw.Row(
             crossAxisAlignment: pw.CrossAxisAlignment.center,
             children: [
               logo,
               pw.Text(
                 Texts.title.toUpperCase(),
                 textAlign: pw.TextAlign.center,
                 style: pw.TextStyle(
                   fontSize: 18,
                   fontWeight: pw.FontWeight.bold,
                 ),
               ),
             ],
           ),
           _buildTableDadosTransformador(),
           _buildTablePotencia(),
           _buildTableNucleo(),
           _buildTablePrimario(),
           _buildTableSecundarios(),
         ];
       },
     ));
     savePDF(pdf);
   }
   

2. 检查表格组件的可分页性
   确保你封装的表格组件（比如_buildTableSecundarios()）使用的是支持分页的pw.Table，并且没有设置强制不可拆分的属性。如果表格本身内容过长，MultiPage会自动将表格拆分到多页。

3. 临时调整maxPages（可选）
   如果你的内容确实需要超过50页，可以适当调高maxPages的值，但这只是临时方案，核心还是要解决无法正常分页的问题，避免无限循环生成空页。

内容的提问来源于stack exchange，提问作者jonathan Cunha 4Cubo