pdf.js 官方不支持运行时动态添加水印，因其定位是纯前端 pdf 渲染器而非文档编辑工具；若需水印效果，应优先在服务端预处理 pdf（如使用 apache pdfbox 或 itext），或采用商业 sdk（如 apryse）实现，避免破坏可访问性与渲染稳定性。
pdf.js 官方不支持运行时动态添加水印，因其定位是纯前端 pdf 渲染器而非文档编辑工具；若需水印效果，应优先在服务端预处理 pdf（如使用 apache pdfbox 或 itext），或采用商业 sdk（如 apryse）实现，避免破坏可访问性与渲染稳定性。
PDF.js 是 Mozilla 开发的开源 HTML5 PDF 查看器，核心目标是准确、安全、高性能地渲染 PDF 内容，而非修改或增强 PDF 文档本身。因此，它不提供任何内置 API（如 setWatermark）用于动态添加水印——该方法根本不存在，调用时必然抛出 TypeError: pageView.setWatermark is not a function 错误。
❌ 为什么客户端水印不可行？
- 架构限制：PDF.js 仅解析并绘制 PDF 页面为 <canvas> 或 <svg>，不维护原始 PDF 结构，无法插入矢量水印层；
- 可访问性风险：强行覆盖渲染层（如用 CSS 叠加半透明文字）会干扰屏幕阅读器、文本复制、搜索及打印，违反 WCAG 标准；
- 安全无效：前端生成的“视觉水印”极易被截图、另存为或禁用 JavaScript 绕过，不具备防泄露效力。
✅ 推荐实践方案
1. 服务端预处理（推荐）
在 Java Web 应用中，于 PDF 交付前注入水印：
// 示例：使用 Apache PDFBox 添加倾斜文字水印
PDDocument doc = PDDocument.load(new File("input.pdf"));
PDPage page = doc.getPage(0);
PDPageContentStream contentStream = new PDPageContentStream(
doc, page, PDPageContentStream.AppendMode.APPEND, true, true);
contentStream.beginText();
contentStream.setFont(PDType1Font.HELVETICA_BOLD, 24);
contentStream.setNonStrokingColor(128, 128, 128, 80); // 灰色半透明
contentStream.setTextMatrix(AffineTransform.getRotateInstance(Math.toRadians(45), 300, 400));
contentStream.showText("CONFIDENTIAL");
contentStream.endText();
contentStream.close();
doc.save("watermarked.pdf");
doc.close();✅ 优势：水印嵌入 PDF 内容流，永久生效、兼容所有阅读器、不影响 PDF.js 渲染逻辑。
Wjs Localizing Video下载用于端到端视频本地化流程的轻量编排器，路由至四个专注子技能——/wjs-transcribing-audio、/wjs-translating-subtitles...
2. 商业 SDK 替代方案
如需前端动态控制（如按用户角色切换水印），可评估 Apryse PDF.js 等商业库，其提供：
- 基于 PDF 文档结构的原生水印层；
- 支持条件水印（如登录用户信息、时间戳）；
- 保留可访问性与打印保真度。
⚠️ 注意事项
- 避免 CSS 覆盖式“伪水印”（如 position: absolute; z-index: 999;），会导致文本选择错位、打印缺失、响应式失效；
- 不要尝试 monkey-patch PDF.js 渲染逻辑——维护成本高且易被版本升级破坏；
- 敏感文档水印必须结合后端权限校验（如 JWT 验证 + 动态水印内容），而非仅依赖前端展示。
总之，PDF.js 的设计哲学是“专注渲染”，水印属于文档内容增强范畴，理应由专业 PDF 处理库在服务端完成。坚持这一分层原则，才能兼顾功能可靠性、合规性与长期可维护性。
