使用Django ReportLab生成PDF报错：'list'无'getKeepWithNext'属性

我尝试生成如下图所示的PDF：

以下是我的代码：

doc = doc = SimpleDocTemplate(invoice_name)
flowable = []
flowable.append(Paragraph(invoice_name))
flowable.append(Paragraph(invoice_number))
flowable.append(Paragraph(invoice_date))
flowable.append(Spacer(1,4))

t = Table(table_data)
flowable.append(t)
flowable.append(Spacer(1,4))

flowable.append(Paragraph(comment_and_amount))

doc.build(flowable)

运行时出现错误：'list' object has no attribute 'getKeepWithNext'

问题原因 #

这个错误的核心原因是**table_data中包含了列表类型的元素**，ReportLab的Table组件要求每个单元格的内容必须是可直接渲染的Flowable对象（如Paragraph、字符串），不能嵌套列表。

解决方法 #

1. 检查并修正table_data结构
   遍历table_data，确保每个单元格的内容不是列表。如果需要在单个单元格中显示多行内容，改用以下方式：

   • 使用Paragraph配合HTML换行符<br/>，需要先导入ParagraphStyle并开启HTML支持：

     from reportlab.lib.styles import ParagraphStyle
     
     # 定义支持HTML的样式
     multi_line_style = ParagraphStyle(name='MultiLine', allowHtml=True)
     # 单元格内容替换为带<br/>的Paragraph
     table_data = [
         ["商品名称", Paragraph("商品详情行1<br/>商品详情行2", style=multi_line_style)],
         ["总价", "¥100.00"]
     ]
     

   • 如果是需要列表样式的内容，使用ListFlowable组件包裹：

     from reportlab.platypus import ListFlowable, ListItem
     
     list_content = ListFlowable(
         [ListItem(Paragraph("列表项1")), ListItem(Paragraph("列表项2"))]
     )
     table_data = [["项目清单", list_content]]
     

2. 排查其他可能的列表嵌套
   确认flowable列表中没有误加列表类型的元素，所有添加的内容必须是单个Flowable对象（Paragraph、Spacer、Table等）。

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