Java 实现 PDF 文字与图片水印添加及 MinIO 下载实战

本文介绍基于 iTextPDF 库在 Java 中实现 PDF 文字和图片水印添加的方法，并封装了通用工具类以适配不同操作系统字体。结合 MinIO 对象存储，演示了在文件下载接口中自动为 PDF 添加水印的实战流程，包括临时文件处理、资源释放及异常解决，适用于企业级文档版权保护与脱敏场景。

信号故障发布于 2026/3/29更新于 2026/4/141 浏览

在日常开发中，PDF 加水印是非常常见的需求，比如文件脱敏、版权标识等场景。本文将基于 iTextPDF 库实现 PDF 文件的文字水印和图片水印添加，并结合 MinIO 文件下载场景，实现下载 PDF 时自动添加水印的实战功能。

一、技术选型与依赖配置

1. 核心依赖 本文使用 iTextPDF 作为 PDF 处理核心库，该库是 Java 生态中处理 PDF 的经典工具，支持 PDF 的创建、修改、水印添加等几乎所有操作。

Maven 依赖配置

<!-- iTextPDF 核心依赖 -->
<dependency>
    <groupId>com.itextpdf</groupId>
    <artifactId>itextpdf</artifactId>
    <version>5.5.13.3</version>
</dependency>
<!-- 中文字体支持 -->
<dependency>
    <groupId>com.itextpdf</groupId>
    <artifactId>itext-asian</artifactId>
    <version>5.2.0</version>
</dependency>
<!-- MinIO 客户端依赖（如果用到 MinIO 下载场景） -->
<dependency>
    <groupId>io.minio</groupId>
    <artifactId>minio</artifactId>
    <version>8.5.7</version>



    commons-io
    commons-io
    2.15.1

相关免费在线工具

Keycode 信息

查找任何按下的键的javascript键代码、代码、位置和修饰符。在线工具，Keycode 信息在线工具，online

Escape 与 Native 编解码

JavaScript 字符串转义/反转义；Java 风格 \uXXXX（Native2Ascii）编码与解码。在线工具，Escape 与 Native 编解码在线工具，online

JavaScript / HTML 格式化

使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。在线工具，JavaScript / HTML 格式化在线工具，online

JavaScript 压缩与混淆

Terser 压缩、变量名混淆，或 javascript-obfuscator 高强度混淆（体积会增大）。在线工具，JavaScript 压缩与混淆在线工具，online

Base64 字符串编码/解码

将字符串编码和解码为其 Base64 格式表示形式即可。在线工具，Base64 字符串编码/解码在线工具，online

Base64 文件转换器

将字符串、文件或图像转换为其 Base64 表示形式。在线工具，Base64 文件转换器在线工具，online

package com.tydt.util; import com.itextpdf.text.Element; import com.itextpdf.text.Image; import com.itextpdf.text.pdf.*; import java.io.File; import java.io.FileOutputStream; /** * PDF 添加水印工具类 * 支持文字水印、图片水印两种方式 */ public class PDFUtil { /** * PDF 添加图片水印 * @param srcPath 源 PDF 文件路径 * @param destPath 加水印后 PDF 输出路径 * @param imagePath 水印图片路径 * @throws Exception 处理异常 */ public static void addPDFImageWaterMark(String srcPath, String destPath, String imagePath) throws Exception { // 1. 读取源 PDF 文件 PdfReader reader = new PdfReader(srcPath); // 2. 创建 PDF Stamper（用于修改 PDF） PdfStamper stamper = new PdfStamper(reader, new FileOutputStream(destPath)); // 3. 加载水印图片 Image image = Image.getInstance(imagePath); // 4. 设置水印透明度 PdfGState gs = new PdfGState(); gs.setFillOpacity(0.2f); // 透明度 0.2（0-1，值越小越淡） PdfContentByte content = null; // 5. 遍历 PDF 所有页面添加水印 int totalPages = reader.getNumberOfPages(); for (int i = 0; i < totalPages; i++) { // 获取当前页面尺寸 float pageWidth = reader.getPageSize(i + 1).getWidth(); float pageHeight = reader.getPageSize(i + 1).getHeight(); // 获取页面的上层内容（水印需放在上层） content = stamper.getOverContent(i + 1); content.setGState(gs); // 应用透明度 // 循环添加水印（每页 3 列 7 行，均匀分布） for (int j = 0; j < 3; j++) { for (int k = 0; k < 7; k++) { // 设置图片水印位置 image.setAbsolutePosition(pageWidth / 3 * j - 30, pageHeight / 7 * k - 20); content.addImage(image); } } } // 6. 关闭资源 stamper.close(); reader.close(); } /** * PDF 添加文字水印 * @param srcPath 源 PDF 文件路径 * @param destPath 加水印后 PDF 输出路径 * @param waterMarkText 水印文字内容 * @throws Exception 处理异常 */ public static void addPDFWaterMark(String srcPath, String destPath, String waterMarkText) throws Exception { // 1. 读取源 PDF 文件 PdfReader reader = new PdfReader(srcPath); PdfStamper stamper = new PdfStamper(reader, new FileOutputStream(destPath)); // 2. 适配 Windows/Linux 系统字体（解决中文乱码） String fontPath = null; String osName = System.getProperties().getProperty("os.name"); if (osName.startsWith("win") || osName.startsWith("Win")) { // Windows 系统宋体 fontPath = "C:\\Windows\\Fonts\\SIMSUN.TTC,1"; } else { // Linux 系统中文字体（需提前安装中文字体） fontPath = "/usr/share/fonts/chinese/TrueType/uming.ttf"; } // 3. 创建基础字体（支持中文） BaseFont baseFont = BaseFont.createFont(fontPath, BaseFont.IDENTITY_H, BaseFont.NOT_EMBEDDED); // 4. 设置水印透明度 PdfGState gs = new PdfGState(); gs.setFillOpacity(0.2f); // 文字透明度 PdfContentByte content = null; // 5. 遍历所有页面添加水印 int totalPages = reader.getNumberOfPages(); for (int i = 0; i < totalPages; i++) { float pageWidth = reader.getPageSize(i + 1).getWidth(); float pageHeight = reader.getPageSize(i + 1).getHeight(); content = stamper.getOverContent(i + 1); content.setGState(gs); content.beginText(); content.setFontAndSize(baseFont, 20); // 设置字体和字号 // 循环添加水印（每页 3 列 7 行，旋转 25 度，避免遮挡内容） for (int j = 0; j < 3; j++) { for (int k = 0; k < 7; k++) { // 参数说明：对齐方式、文字内容、X 坐标、Y 坐标、旋转角度 content.showTextAligned(Element.ALIGN_CENTER, waterMarkText, pageWidth / 3 * j + 90, pageHeight / 7 * k, 25); } } content.endText(); } // 6. 关闭资源 stamper.close(); reader.close(); } // 测试方法 public static void main(String[] args) { // 批量给指定目录的 PDF 添加文字水印 File pdfDir = new File("D:\\wps"); for (File pdfFile : pdfDir.listFiles()) { if (pdfFile.getName().endsWith(".pdf")) { try { System.out.println("正在处理：" + pdfFile.getName()); String srcPath = "D:\\wps\\" + pdfFile.getName(); String destPath = "D:\\wps\\waterMark\\" + pdfFile.getName(); // 添加文字水印 addPDFWaterMark(srcPath, destPath, "天津港项目有限公司"); } catch (Exception e) { e.printStackTrace(); } } } } }

import io.minio.StatObjectResponse; import org.apache.commons.io.IOUtils; import org.springframework.util.Assert; import javax.servlet.http.HttpServletResponse; import java.io.File; import java.io.InputStream; import java.net.URLEncoder; /** * 通用文件下载接口（PDF 自动加水印） */ @RestController @RequestMapping("/file") public class FileDownloadController { @Autowired private MinioTemplate minioTemplate; @Autowired private MinioConfig minioConfig; @Autowired private FileService fileService; // 临时文件夹（需提前创建，建议配置在 application.yml） private String destFolder = "/tmp/pdf_watermark"; // 水印文字常量 private static final String WATER_MARK = "天津港项目有限公司"; /** * 通用附件下载 * @param fileId 文件 ID * @param response 响应对象 * @throws Exception 处理异常 */ @ApiOperation("通用附件下载") @GetMapping("/download") @ApiImplicitParams({ @ApiImplicitParam(name = "fileId", value = "文件 ID", required = true) }) public void download(String fileId, HttpServletResponse response) throws Exception { // 1. 校验 MinIO 桶是否存在 String bucketName = minioConfig.getBucketName(); boolean bucketExists = minioTemplate.bucketExists(bucketName); Assert.isTrue(bucketExists, "文件存储桶不存在！"); // 2. 查询文件信息 UploadFilePO uploadFilePo = fileService.queryFileDetail(fileId); Assert.notNull(uploadFilePo, "文件不存在或已被删除！"); // 3. 获取 MinIO 文件元信息 StatObjectResponse statObject = minioTemplate.getStatObjectResponse( bucketName, uploadFilePo.getFilePath(), uploadFilePo.getVersionId()); // 4. 设置响应头（文件下载） response.setContentType(statObject.contentType()); response.setHeader("Content-Disposition", "attachment;filename=" + URLEncoder.encode(uploadFilePo.getRealName(), "UTF-8")); // 5. 区分 PDF 和非 PDF 文件处理 if ("pdf".equals(uploadFilePo.getFileType())) { // 5.1 从 MinIO 获取 PDF 文件输入流 InputStream inputStream = minioTemplate.getObject( bucketName, uploadFilePo.getFilePath(), uploadFilePo.getVersionId()); // 5.2 创建临时文件（避免并发冲突，使用雪花 ID 命名） String tempDir = destFolder + File.separator + IdUtils.snowflakeNewId(); File tempDirFile = new File(tempDir); if (!tempDirFile.exists()) { tempDirFile.mkdirs(); // 创建多级目录 } String tempSrcPdf = tempDir + File.separator + uploadFilePo.getFileName(); String tempDestPdf = tempDir + File.separator + uploadFilePo.getRealName(); // 5.3 将 MinIO 的 PDF 写入临时文件 org.apache.commons.io.FileUtils.copyToFile(inputStream, new File(tempSrcPdf)); // 5.4 给 PDF 添加水印 PDFUtil.addPDFWaterMark(tempSrcPdf, tempDestPdf, WATER_MARK); // 5.5 将加水印后的 PDF 写入响应流 FileUtils.writeBytes(tempDestPdf, response.getOutputStream()); // 5.6 删除临时文件（避免磁盘占用） org.apache.commons.io.FileUtils.forceDelete(tempDirFile); } else { // 非 PDF 文件直接下载 InputStream inputStream = minioTemplate.getObject( bucketName, uploadFilePo.getFilePath(), uploadFilePo.getVersionId()); IOUtils.copy(inputStream, response.getOutputStream()); } } }

Java 实现 PDF 文字与图片水印添加及 MinIO 下载实战

一、技术选型与依赖配置

更多推荐文章

相关免费在线工具

二、核心工具类实现（PDFUtil）

三、实战场景：MinIO 下载 PDF 自动加水印

四、常见问题与解决方案

五、总结

Java 实现 PDF 文字与图片水印添加及 MinIO 下载实战

一、技术选型与依赖配置

微信扫一扫，关注极客日志

更多推荐文章

相关免费在线工具

二、核心工具类实现（PDFUtil）

三、实战场景：MinIO 下载 PDF 自动加水印

四、常见问题与解决方案

五、总结