Java Spring Boot集成iTextPDF 5.5.10生成PDF后无法立即删除问题排查求助

看起来你遇到的是文件句柄未及时释放的问题——虽然你调用了关闭方法，但Java进程仍持有文件引用，直到垃圾回收延迟释放才允许删除。我来帮你定位并修复这个问题：

问题根源 #

在iTextPDF 5.x中，Document.close()理论上会触发PdfWriter关闭并释放底层FileOutputStream，但如果没有显式管理输出流，或者关闭顺序不当，就可能导致文件句柄被长期占用（这就是为什么10-15分钟后才能删除的原因，因为此时Java GC才回收了未释放的资源）。

修复方案 #

我们需要显式持有文件输出流的引用，确保所有资源按正确顺序关闭，彻底释放文件句柄：

1. 修改MyPdfWriter类，显式管理资源

public class MyPdfWriter {
    private Document document;
    private PdfWriter writer;
    private FileOutputStream fos; // 新增：保存文件输出流引用
    // ... 原有字体、常量定义

    public MyPdfWriter(String filename, String filepath) throws IOException, DocumentException {
        // 用File对象处理路径，避免拼接错误
        File pdfFile = new File(filepath, filename);
        this.fos = new FileOutputStream(pdfFile);
        
        this.document = new Document(PageSize.A4);
        this.document.setMargins(PAGE_MARGIN, PAGE_MARGIN, PAGE_MARGIN, PAGE_MARGIN);
        this.writer = PdfWriter.getInstance(this.document, fos);
        
        this.document.open();
        // 元数据、字体初始化（原有代码不变）
        this.document.addTitle(filename);
        this.document.addAuthor(ShiroUtils.getSysUser().getUserName());
        
        BaseFont bfChinese = BaseFont.createFont("STSong-Light", "UniGB-UCS2-H", BaseFont.NOT_EMBEDDED);
        this.titleFont = new Font(bfChinese, 16, Font.BOLD);
        this.pFont = new Font(bfChinese, 12, Font.NORMAL);
        // ... 其他字体初始化
    }

    // 原有addTitle、addParagraph等方法保持不变

    /**
     * 安全关闭所有资源：按Document → Writer → 输出流的顺序释放
     */
    public void closeWriter() {
        // 用try-finally确保资源必被关闭，避免异常导致泄漏
        try {
            if (document != null && document.isOpen()) {
                document.close(); // Document关闭会自动触发Writer的关闭逻辑
            }
        } catch (Exception e) {
            e.printStackTrace();
        } finally {
            try {
                if (writer != null) {
                    writer.close(); // 二次确保Writer关闭
                }
            } catch (Exception e) {
                e.printStackTrace();
            } finally {
                try {
                    if (fos != null) {
                        fos.close(); // 显式关闭文件输出流，这是解决问题的关键！
                    }
                } catch (IOException e) {
                    e.printStackTrace();
                }
            }
        }
    }
}

2. 确保closeWriter()必被调用

在ReportServiceImpl中，将关闭操作放在finally块里，避免异常导致资源未释放：

@Override
public int generateReport(Map<String, Object> data) {
    MyPdfWriter writer = null;
    try {
        String filename = ...;
        String filepath = ...;
        writer = new MyPdfWriter(filename, filepath);
        // 写入PDF内容
        writer.addTitle(...);
        writer.addParagraph(...);
        // ... 其他写入操作
    } catch (Exception e) {
        e.printStackTrace();
        return -1;
    } finally {
        // 无论是否报错，都关闭资源
        if (writer != null) {
            writer.closeWriter();
        }
    }
    return 1;
}

3. 可选：用try-with-resources简化代码（Java 7+推荐）

让MyPdfWriter实现AutoCloseable，可以自动管理资源：

public class MyPdfWriter implements AutoCloseable {
    // ... 现有所有代码

    @Override
    public void close() throws Exception {
        closeWriter();
    }
}

// 使用时：
@Override
public int generateReport(Map<String, Object> data) {
    try (MyPdfWriter writer = new MyPdfWriter(filename, filepath)) {
        // 写入PDF内容
        writer.addTitle(...);
        writer.addParagraph(...);
    } catch (Exception e) {
        e.printStackTrace();
        return -1;
    }
    return 1;
}

额外排查点 #

如果修改后仍无法立即删除，检查：

• 是否有杀毒软件、文件预览工具等第三方进程正在扫描/读取该文件
• 确保你的程序没有其他线程持有该文件的引用

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