FPDF2代码封装为函数后抛出“Content cannot be added on a finalized document, after calling output()”异常的问题排查

嗨，我来帮你捋捋这个问题～你碰到的这个报错，核心原因大概率是变量作用域冲突，或者你的pdfTablePrep函数没有正确绑定当前函数内创建的PDF对象。

先帮你拆解下问题本质：当代码直接放在主循环里时，每次循环都会生成全新的pdf对象，所有内容操作都是针对这个新对象，自然不会有问题。但封装成函数后，就容易踩变量作用域的坑，具体可能是这两个情况：

1. pdfTablePrep函数依赖全局pdf变量 #

你的代码里调用了pdfTablePrep(hotspot_df)和pdfTablePrep(filtered_sub_df)，但如果这个函数没有把当前的PDF对象作为参数传入，而是默认操作全局的pdf变量——那麻烦就来了！
比如你之前在函数外定义过全局的pdf，第一次调用create_doc时，函数里虽然创建了局部的pdf新对象，但pdfTablePrep还是会去操作那个已经被output()过的全局pdf，这时候就会抛出“文档已被finalized”的错误。

2. 函数内复用了已被output()的旧pdf对象 #

如果函数里没有正确初始化新的pdf对象（比如不小心漏写了pdf = FPDF(...)，或者代码里意外引用了全局的pdf），那么多次调用函数时，会复用同一个已经完成输出的PDF对象，后续再添加内容自然会报错。

解决步骤 #

给你几个具体的修复方向：

• 修改pdfTablePrep函数，让它接收PDF对象作为参数
  把函数改成需要传入当前操作的PDF实例，比如：

  def pdfTablePrep(df, pdf):
      # 函数内所有的PDF操作都使用传入的这个pdf对象
      # 示例：pdf.cell(w=pw, h=ch, txt="示例内容", border=1)
  

  然后在create_doc里调用时，传入局部的pdf：

  pdfTablePrep(hotspot_df, pdf)
  pdfTablePrep(filtered_sub_df, pdf)
  

• 确保函数内的pdf是全新的局部对象
  在create_doc函数的开头，一定要重新实例化FPDF，不要依赖全局变量。比如函数开头应该是：

  def create_doc(subject):
      # 初始化全新的PDF对象，作为函数局部变量
      pdf = FPDF(orientation='P', unit='mm', format='A4')
      pdf.add_page()
      # 后续的字体设置、内容添加都基于这个局部pdf
  

  （注意你原来的代码片段里有两次pdf = FPDF(...)，属于冗余代码，要删掉重复的横版A4初始化，保留正确的竖版配置）

• 严格控制代码执行顺序
  确保所有添加内容的操作（pdf.cell、pdfTablePrep调用）都在pdf.output()之前执行，output()之后绝对不能再对该PDF对象做任何操作。

你可以先试试修改pdfTablePrep的参数传递，这应该是最常见的触发原因～

备注：内容来源于stack exchange，提问作者Paul