Spring Boot项目中替代Jasper的Java PDF生成方案推荐

Hey there! Sorry to hear you had such a rough go with Jasper Reports—those clunky XML templates and random rendering glitches are frustrating enough, and not being able to use Jasper Studio smoothly with IntelliJ IDEA just adds insult to injury. Let’s break down some top-tier Java-based alternatives that let you use HTML templates (with data binding) to generate PDFs, exactly like you’re asking for.

1. Thymeleaf + Flying Saucer (OpenPDF) #

This combo is perfect for Spring Boot projects, since Thymeleaf is the go-to template engine for many Spring devs, and it plays beautifully with IntelliJ (full syntax highlighting, auto-completion, all the good stuff).

How it works: #

• Use Thymeleaf to write HTML templates with data binding (just like you would for web pages—${user.name}, loops, conditionals, etc.).
• Feed the rendered HTML to Flying Saucer, which converts it to a polished PDF using CSS for styling (you can even use Bootstrap for responsive layouts that translate well to PDF).

Quick Example: #

First, add the dependencies to your pom.xml (or build.gradle):

<!-- Thymeleaf -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-thymeleaf</artifactId>
</dependency>
<!-- Flying Saucer with OpenPDF -->
<dependency>
    <groupId>org.xhtmlrenderer</groupId>
    <artifactId>flying-saucer-pdf-openpdf</artifactId>
    <version>9.1.22</version>
</dependency>

Then, a simple service method to generate the PDF:

@Autowired
private TemplateEngine templateEngine;

public byte[] generateBillPdf(Bill bill) throws IOException {
    // Render Thymeleaf template to HTML
    Context context = new Context();
    context.setVariable("bill", bill);
    String html = templateEngine.process("bill-template", context);

    // Convert HTML to PDF
    ByteArrayOutputStream outputStream = new ByteArrayOutputStream();
    ITextRenderer renderer = new ITextRenderer();
    renderer.setDocumentFromString(html);
    renderer.layout();
    renderer.createPDF(outputStream);

    return outputStream.toByteArray();
}

Why it’s great: #

• No more XML templates—write clean, familiar HTML/CSS.
• Seamless Spring Boot integration, with full IDE support in IntelliJ.
• Handles complex layouts (tables, headers/footers, page breaks) with CSS.

2. Freemarker + iText 7 #

If you need more advanced PDF features (like encryption, digital signatures, fillable forms, or dynamic page numbering), iText 7 is a powerhouse. Pair it with Freemarker (another flexible template engine) for HTML-based data binding.

How it works: #

• Create Freemarker templates to bind your data and generate HTML.
• Use iText 7’s HtmlConverter to turn that HTML into a feature-rich PDF.

Quick Example: #

Add dependencies:

<!-- Freemarker -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-freemarker</artifactId>
</dependency>
<!-- iText 7 HTML to PDF -->
<dependency>
    <groupId>com.itextpdf</groupId>
    <artifactId>html2pdf</artifactId>
    <version>3.0.4</version>
</dependency>

Service method snippet:

@Autowired
private Configuration freemarkerConfig;

public byte[] generateReportPdf(ReportData data) throws IOException, TemplateException {
    // Render Freemarker template to HTML
    Template template = freemarkerConfig.getTemplate("report-template.ftl");
    StringWriter writer = new StringWriter();
    template.process(data, writer);
    String html = writer.toString();

    // Convert HTML to PDF with iText 7
    ByteArrayOutputStream outputStream = new ByteArrayOutputStream();
    HtmlConverter.convertToPdf(html, outputStream);

    return outputStream.toByteArray();
}

Why it’s great: #

• iText 7 supports almost every PDF feature you could need.
• Freemarker templates are lightweight and easy to maintain.
• Works well with Spring Boot, and IntelliJ has solid Freemarker support.

3. Apache PDFBox + Thymeleaf/Freemarker #

Apache PDFBox is a free, open-source library for creating and manipulating PDFs. While it doesn’t directly convert HTML to PDF out of the box, you can pair it with Thymeleaf or Freemarker to generate HTML first, then use PDFBox’s rendering utilities (or a helper library like pdfbox-html2pdf) to convert it.

Why it’s great: #

• 100% open-source, with a large community.
• Highly customizable—you can tweak every aspect of the PDF if needed.
• Perfect if you want full control over the PDF generation process.

Quick Selection Tips #

• For most Spring Boot projects: Go with Thymeleaf + Flying Saucer. It’s the easiest to set up, integrates seamlessly, and avoids all the Jasper headaches you faced.
• For advanced PDF features: Pick Freemarker + iText 7. It’s more powerful, though there’s a slight learning curve for iText’s advanced APIs.
• For open-source purists or custom needs: Apache PDFBox is a solid choice.

内容的提问来源于stack exchange，提问作者E . Younes