Java的try-with-resources可自动关闭实现AutoCloseable的PDF资源，如iText 7的PdfWriter、PdfDocument和PDFBox的PDDocument等，但需注意版本兼容性与构造参数（如PDPageContentStream是否自动关闭流），并确保异常时正确处理抑制异常。
Java 的 try-with-resources 能自动关闭实现了 AutoCloseable 的资源，对 PDF 生成这类 I/O 密集操作特别有用——避免因忘记关闭流或文档导致内存泄漏、文件锁死、磁盘空间占用等问题。
确保 PDF 库资源支持自动关闭
不是所有 PDF 操作类都默认实现 AutoCloseable，需确认你用的库版本和类是否满足条件：
- iText 7+：`PdfWriter`、`PdfDocument`、`FileOutputStream` 都实现了 `AutoCloseable`，可直接用于 try-with-resources。
- Apache PDFBox：`PDDocument`、`PDPageContentStream`、`FileOutputStream` 同样支持，但注意 `PDPageContentStream` 构造时若传入 `false`（不自动关闭底层流），则它自身关闭不会触发流关闭，需单独管理。
- 旧版 iText 5：`Document` 和 `PdfWriter` 不实现 `AutoCloseable`，不能直接用于 try-with-resources，需手动调用 `close()`。
典型 iText 7 写法：嵌套资源一次性释放
PDF 生成常涉及多个层级资源（文件流 → writer → document → 页面内容），try-with-resources 可按声明顺序逆序关闭：
try (FileOutputStream fos = new FileOutputStream("output.pdf");
PdfWriter writer = new PdfWriter(fos);
PdfDocument pdfDoc = new PdfDocument(writer);
Document doc = new Document(pdfDoc)) {
doc.add(new Paragraph("Hello, PDF!"));
// 自动添加页面、写入内容等
} catch (IOException e) {
// 处理 I/O 异常
}
执行结束时，`doc`、`pdfDoc`、`writer`、`fos` 会按相反顺序依次调用 `close()`，无需手动干预。
你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在
立即学习“Java免费学习笔记（深入）”；
处理异常时的关闭行为要留意
try-with-resources 保证资源关闭，但若多个资源关闭过程中抛出异常，只有第一个异常被抛出，其余会被抑制（可通过 `Throwable.getSuppressed()` 获取）。实践中建议：
- 在 catch 块中检查是否有被抑制异常，尤其当 PDF 文件生成后为空或损坏时；
- 避免在资源构造器中做重逻辑（如预校验、网络请求），否则构造失败会导致资源未创建，无法进入关闭流程；
- 若需在关闭前做清理（如写入 footer、更新元数据），应放在 try 块末尾，而非依赖 close() 方法内部逻辑。
PDFBox 示例：注意流生命周期控制
以 PDFBox 为例，正确写法需确保 `PDDocument` 关闭时能真正释放底层资源：
try (PDDocument doc = new PDDocument();
PDPage page = new PDPage();
PDPageContentStream content = new PDPageContentStream(doc, page)) {
doc.addPage(page);
content.beginText();
content.showText("Hello from PDFBox");
content.endText();
} catch (IOException e) {
// 处理异常
}
这里 `PDPageContentStream` 默认启用自动关闭底层流（构造时第二个参数为 `true`），所以 `content.close()` 会关闭其关联的 `PDDocument` 内部流。若显式设为 `false`，就必须自己确保 `PDDocument.save()` 后再关闭 `FileOutputStream`。
