使用C# iText7生成多页PDF表格时遇“PdfPages树仅能生成一次”错误

错误原因 #

直接用Clone(true)深度克隆原始表格的单元格时，单元格内的复杂元素（比如嵌套表格）会保留与原表格生成上下文的关联。当这些克隆单元格被添加到新表格并渲染时，iText会尝试重复生成PDF页面树结构，从而触发该错误。简单单元格（仅含段落）无此问题，是因为其内容没有上下文关联的复杂结构。

修复方案 #

不要直接克隆原始单元格，而是重新创建新单元格，再将原始单元格的内容元素逐个复制到新单元格中，避免上下文关联重复的问题。

修改后的核心代码片段 #

替换原代码中克隆单元格的部分：

// 替换原克隆单元格的代码
Cell newCell = new Cell();
Cell originalCell = table1.GetCell(currentRow, 0);

// 复制原始单元格的样式属性
newCell.SetBorder(originalCell.GetBorder())
       .SetBackgroundColor(originalCell.GetBackgroundColor())
       .SetPadding(originalCell.GetPadding())
       .SetWidth(originalCell.GetWidth());

// 遍历并复制原始单元格的所有子元素
foreach (var element in originalCell.GetChildren())
{
    if (element is Table nestedTable)
    {
        // 递归复制嵌套表格
        Table clonedNestedTable = new Table(nestedTable.GetNumberOfColumns())
            .SetWidth(nestedTable.GetWidth());
        
        foreach (var nestedRow in nestedTable.GetRows())
        {
            Row newRow = new Row();
            foreach (var nestedCell in nestedRow.GetCells())
            {
                Cell clonedNestedCell = new Cell();
                foreach (var nestedChild in nestedCell.GetChildren())
                {
                    clonedNestedCell.Add(nestedChild.Clone(false));
                }
                // 复制嵌套单元格样式
                clonedNestedCell.SetBorder(nestedCell.GetBorder())
                                .SetPadding(nestedCell.GetPadding());
                newRow.AddCell(clonedNestedCell);
            }
            clonedNestedTable.AddRow(newRow);
        }
        newCell.Add(clonedNestedTable);
    }
    else
    {
        // 普通元素（段落、文本等）浅克隆即可
        newCell.Add(element.Clone(false));
    }
}
subTable.AddCell(newCell);

额外说明 #

• 使用Clone(false)进行浅克隆，避免复制元素的文档上下文关联；
• 若原始单元格有自定义样式（字体、对齐方式等），需要手动对应复制到新单元格；
• 递归处理嵌套表格是为了确保所有子元素都脱离原上下文，避免重复触发页面树生成逻辑。

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