pypdf2合并水印页不显示，因水印pdf空白或尺寸不匹配：需用reportlab设透明度（setalpha）、手动定位文字、确保页面尺寸与目标pdf一致，并指定中文字体避免乱码。
用 PyPDF2 合并水印页时为什么水印不显示？
PyPDF2 本身不支持直接绘图，所谓“添加水印”本质是把一张含水印的 PDF 页面（比如用 ReportLab 生成的透明文字页）叠在原 PDF 的每一页上。如果水印页空白或尺寸不匹配，叠加后就看不到——常见原因是 ReportLab 生成的水印 PDF 没设透明度、没居中、或坐标超出裁剪区域。
实操建议：
Python 3.14.2
下载
Python 3.14.2是Python编程语言在2025年12月5日发布的稳定版本，属于3.14系列的第二个维护更新。该版本包含了18项修复，重点解决了多进程、数据类及正则表达式等模块的回归问题，并修复了CVE-2025-12084等安全漏洞。此版本标志着自由线程模式（移除GIL）正式获得官方支持，是Python发展的重要里程碑。
- 水印页必须用
canvas.saveState()+canvas.setAlpha(0.1)控制透明度，否则会遮盖正文 - 用
canvas.setFont("Helvetica", 60)和canvas.rotate(30)配合canvas.drawString(x, y, "CONFIDENTIAL")手动定位，别依赖自动居中 - 生成水印页时，尺寸要和目标 PDF 一致：读取原 PDF 第一页的
mediabox，用letter或A4等预设尺寸容易错位
pdfplumber + reportlab 组合能否实现动态水印内容？
可以，但不是在渲染阶段插入，而是在生成水印页时动态写入变量。比如按文件名加时间戳，或从 Excel 读取每份 PDF 对应的客户编号。
实操建议：
- 把水印文本做成变量传给
draw_watermark()函数，例如text = f"ID: {client_id} — {datetime.now().strftime('%Y%m%d')}" - 避免在循环里反复调用
canvas.save()，应为每个水印内容单独生成一页 PDF，再用PageObject.merge_page()叠加 - 注意编码：中文需指定 TrueType 字体，如
canvas.setFont("SimSun", 48)，且确保系统有该字体文件，否则报KeyError: 'SimSun'
批量处理时遇到 “PdfReadError: Not a PDF file” 怎么排查？
这通常不是文件损坏，而是脚本误把非 PDF 文件（比如 .DS_Store、临时缩略图、带隐藏扩展名的 .pdf.txt）当成了 PDF。PyPDF2 对文件头校验严格，开头不是 %PDF- 就直接抛错。
实操建议：
- 加一层文件过滤：
if filename.lower().endswith(".pdf") and os.path.getsize(filepath) > 1024 - 用
magic库验证 MIME 类型：import magic; mime = magic.Magic(mime=True); if mime.from_file(filepath) == "application/pdf" - 跳过加密 PDF：先用
reader.is_encrypted判断，True 就continue或统一解密（需密码）
用 pikepdf 替代 PyPDF2 有什么实际好处？
pikepdf 是基于 qpdf 的现代库，对 PDF 结构操作更底层、更稳定，尤其适合批量加水印这种高频修改场景。它不会像 PyPDF2 那样因元数据异常或流压缩问题导致合并失败。
实操建议：
- 安装：
pip install pikepdf，注意 Windows 用户可能需要先装 Visual C++ Build Tools - 叠加水印页更简洁：
overlay = pikepdf.Pdf.open(watermark_pdf); page.add_overlay(overlay.pages[0]) - 保留原始 PDF 的书签、链接、表单字段：PyPDF2 会丢弃这些，而
pikepdf默认保持preserve_metadata=True - 性能差异明显：处理 100 页 PDF，pikepdf 通常比 PyPDF2 快 2–3 倍，且内存占用更低
pdfinfo 看下目标文件的页面尺寸和是否加密，比直接跑脚本更省时间。Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
