ReportLab PageTemplate中Frame生成PDF时重叠原因排查

我用ReportLab Platypus创建包含2个Frame的PageTemplate，预期两个Frame上下堆叠，各占文档全宽和一半高度：

• 底部Frame从文档左下角开始，高度为文档高度的一半
• 顶部Frame从文档左侧半高位置开始，高度同样为文档高度的一半

但实际生成的PDF中，两个Frame存在1英寸的重叠（将顶部Frame上移1英寸即可完美堆叠）。已核对文档页面尺寸、高度、边距及Frame参数，仍未找到原因。

生成代码 #

from reportlab.platypus import BaseDocTemplate, Frame, FrameBreak, Paragraph, NextPageTemplate, PageBreak, PageTemplate
from reportlab.lib.units import inch
from reportlab.lib.styles import getSampleStyleSheet


styles=getSampleStyleSheet()
Elements=[]

doc = BaseDocTemplate('testdoc.pdf', showBoundary = 1)

frame1 = Frame(doc.leftMargin, doc.bottomMargin, doc.width, doc.height / 2, showBoundary = 1, id = 'BottomFrame')
frame2 = Frame(doc.leftMargin, doc.height / 2, doc.width, doc.height / 2 , showBoundary = 1, id = 'TopFrame')

Elements.append(Paragraph("Top-bottom frames, " * 100, styles['Normal']))
Elements.append(FrameBreak())
Elements.append(Paragraph("Top-bottom frames, " * 100, styles['Normal']))

doc.addPageTemplates([PageTemplate(id = 'TwoRows', frames = [frame2, frame1])])

#start the construction of the pdf
doc.build(Elements)

打印的参数信息 #

print(doc.pagesize) : (595.2755905511812, 841.8897637795277)
print(doc.height) : 697.8897637795277
print(doc.topMargin) : 72.0
print(doc.bottomMargin) : 72.0
print(frame1.y1) : 72.0
print(frame1.height) : 348.94488188976385
print(frame1.y1) : 348.94488188976385
print(frame2.height) : 348.94488188976385

解决方案 #

问题出在顶部Frame的y坐标计算错误：doc.height是内容区域的高度（已减去上下边距），而Frame的y参数是相对于页面左下角的绝对位置，不是内容区域的相对位置。

原来的顶部Frame用doc.height / 2作为y坐标，这个值只是内容区域的中点，但从页面左下角算起，需要加上底部边距才是内容区域中点的绝对位置。底部Frame的顶部位置是doc.bottomMargin + doc.height / 2，而原来的顶部Frame的y坐标小于这个值，导致两个Frame重叠了1英寸（72单位）。

修正后的代码 #

修改顶部Frame的y坐标为doc.bottomMargin + doc.height / 2：

from reportlab.platypus import BaseDocTemplate, Frame, FrameBreak, Paragraph, NextPageTemplate, PageBreak, PageTemplate
from reportlab.lib.units import inch
from reportlab.lib.styles import getSampleStyleSheet


styles=getSampleStyleSheet()
Elements=[]

doc = BaseDocTemplate('testdoc.pdf', showBoundary = 1)

frame1 = Frame(doc.leftMargin, doc.bottomMargin, doc.width, doc.height / 2, showBoundary = 1, id = 'BottomFrame')
# 修正顶部Frame的y坐标
frame2 = Frame(doc.leftMargin, doc.bottomMargin + doc.height / 2, doc.width, doc.height / 2 , showBoundary = 1, id = 'TopFrame')

Elements.append(Paragraph("Top-bottom frames, " * 100, styles['Normal']))
Elements.append(FrameBreak())
Elements.append(Paragraph("Top-bottom frames, " * 100, styles['Normal']))

doc.addPageTemplates([PageTemplate(id = 'TwoRows', frames = [frame2, frame1])])

doc.build(Elements)

验证逻辑 #

• 底部Frame的绝对位置：y=72（底部边距），高度≈348.94，顶部y=72+348.94≈420.94
• 修正后的顶部Frame的绝对位置：y=72+348.94≈420.94，高度≈348.94，顶部y=420.94+348.94≈769.88，刚好等于页面总高度841.89减去顶部边距72，完全贴合内容区域，无重叠。

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