背景：

因一个特定的项目需要，将java对象内容以特定样式的PDF格式输出，查看了很多文档，有收费的、免费的、基础集成的。收费的工具就表现突出，免费的工具基本很难满足需求，故着手采用基础集成方案。过程中尝试了很多中技术组合，最后根据个人调试效果选择了\"thymeleaf+htmltopdf\"组合方案。

HTML转PDF效果：

材料：

1、基础JAVA环境

2、测试数据：

{\"newspaper_name\":\"每日新闻\",\"issue_number\":\"1024\",\"issue_date\":\"2025年07月17日\",\"editor_in_chief\":\"王主编\",\"current_year\":2025,\"contact_info\":{\"address\":\"北京市朝阳区新闻大厦18层\",\"phone\":\"010-12345678\",\"email\":\"info@dailynews.com\"},\"headline_news\":{\"title\":\"国家发布新一代人工智能发展规划\",\"reporter\":\"张科技\",\"time\":\"今天 08:15\",\"image\":\"E:\\\\HtmlToPdf\\\\templates\\\\assets\\\\images\\\\headline.jpg\",\"content\":\"\\n 
国务院近日印\\r\\n发《新一代人工智能发展规划》，提出到2030年使中国人工智能理论、技术与应用总体达到世界领先水平，成为世界主要人工智能创新中心。
\\n 
规划明 \\r\\n确了我国新一代人工智能发展的战略目标：到2020年人工智能总体技术和应用与世界先进水平同步；到2025年人工智能基础理论实现重大突破；到2030年人工智能理论、技术与应\\r\\n用总体达到世界领先水平。
\\n 
规划还提出建立开放协同的人工智能科技创新体系，培育高端高效的智能经济，建设安全便捷的智能社会等六大重点任务 \\r\\n。
\\n \"},\"regular_news\":[{\"title\":\"本市地铁新线路今日开通试运营\",\"reporter\":\"李交通\",\"time\":\"今天 07:30\",\"image\":\"E:\\\\HtmlToPdf\\\\templates\\\\assets\\\\images\\\\subway.jpg\",\"content\":\"\\n  
经过四年建设，本市地铁14号线西段今日正式开通试运营。该线路全长16.5公里，设站8座，连\\r\\n接了多个商业区和居民区，将极大缓解西部城区的交通压力。
\\n  
地铁运营公司表示，试运营初期发车间隔为6分钟，未来将根据客流情况逐步缩短间\\r\\n隔时间。首班车时间为5:30，末班车时间为23:00。
\\n \"},{\"title\":\"夏季旅游旺季来临 景区推出多项优惠\",\"reporter\":\"赵旅游\",\"time\":\"昨天 18:45\",\"content\":\"\\n  
随着暑期来临，我市各大旅游景区迎来旅游旺季。为吸引游客，多家景区推出门票优惠活动。
\\n  
其\\r\\n中，著名5A级景区长城从即日起至8月31日，对全日制学生实行半价优惠；本市居民凭身份证可享受8折优惠。此外，多家景区还推出了夜游项目，丰富游客体验。
\\n \\r\\n \"}],\"special_report\":{\"title\":\"乡村振兴战略实施五周年成果展\",\"content\":\"\\n 
今年是乡村振兴战略实施五周年。五年来，我市农村面貌\\r\\n发生显著变化，农民收入持续增长，农业现代化水平明显提高。
\\n 
据统计，五年来我市农村居民人均可支配收入年均增长8.5%，高于城镇居民收入增速 \\r\\n；农村基础设施显著改善，所有行政村实现通硬化路、通宽带；特色农业发展迅速，形成了一批知名农产品品牌。
\\n 
下一步，我市将重点推进乡村产业 \\r\\n振兴、人才振兴、文化振兴、生态振兴和组织振兴，让农村成为安居乐业的美丽家园。
\\n \",\"images\":[{\"url\":\"E:\\\\HtmlToPdf\\\\templates\\\\assets\\\\images\\\\country1.jpg\",\"caption\":\"美丽乡村建设成果\"},{\"url\":\"E:\\\\HtmlToPdf\\\\templates\\\\assets\\\\images\\\\country2.jpg\",\"caption\":\"现代化农业大棚\"},{\"url\":\"E:\\\\HtmlToPdf\\\\templates\\\\assets\\\\images\\\\country3.jpg\",\"caption\":\"乡村旅游新业态\"}]}}

制作：

1、在java项目的pom.xml中添加如下配置

  org.thymeleaf thymeleaf 3.1.1.RELEASE   io.woo htmltopdf 1.0.8 compile

解释：我们是利用thymeleaf 包进行java对象与HTML模板的赋值匹配

2、编写thymeleaf 风格的HTML模板（如下，注意参数格式不是{{}}，而是${}）

    
 
 
报纸名称
 
 第 期号 期 日期 总编辑: 总编辑姓名 
 
 
   
 
今日头条
 
 
   
 
  
头条标题
  
 记者: 记者姓名 发布时间  
  
 头条新闻内容  
 
 
 
  
 
新闻速递
 
 
新闻标题
 
  记者: 记者姓名  发布时间 
 
   
 
  新闻内容 
 
 
  
 
专题报道
 
 
专题标题
 
  专题内容 
 
  
  
图片说明
  
 
 
 
  

3、 模板对应的css样式

/* 基础样式 */body { font-family: \"SimSun\", \"宋体\", serif; line-height: 1.6; color: #333333; margin: 0; padding: 0; font-size: 14px;}/* 报头样式 */.newspaper-header { background-color: #8B0000; color: white; padding: 15px 0; text-align: center; border-bottom: 3px solid #DAA520;}.header-content h1 { font-size: 36px; margin: 0; font-weight: bold; letter-spacing: 2px;}.issue-info { margin-top: 10px; font-size: 14px;}.issue-info span { margin: 0 10px;}/* 内容容器 */.content-container { padding: 20px; width: 1000px; margin: 0 auto;}.section-title { font-size: 22px; border-bottom: 2px solid #8B0000; padding-bottom: 5px; color: #8B0000; margin: 25px 0 15px;}/* 头条新闻 */.headline-news { margin-bottom: 30px;}.headline-article { display: block; margin-top: 15px; overflow: hidden;}.headline-image { float: left; width: 30%; margin-right: 20px;}.headline-image img { width: 100%; height: auto; border: 1px solid #dddddd;}.headline-content { float: left; width: 65%;}.headline-content h3 { font-size: 20px; margin-top: 0; color: #222222;}/* 常规新闻 */.news-item { margin-bottom: 25px; padding-bottom: 15px; border-bottom: 1px dashed #cccccc;}.news-item h3 { font-size: 18px; color: #444444; margin-bottom: 5px;}.news-meta { color: #666666; font-size: 12px; margin: 5px 0;}.news-meta span { margin-right: 15px;}.news-image { margin: 10px 0;}.news-image img { max-width: 100%; height: auto; border: 1px solid #dddddd;}.news-content { text-align: justify; text-indent: 2em;}/* 专题报道 */.special-report { background-color: #f9f9f9; padding: 15px; margin-top: 30px; border: 1px solid #dddddd;}.special-article h3 { font-size: 20px; color: #8B0000; text-align: center;}.report-content { text-align: justify; margin: 15px 0;}.report-gallery { display: block; margin: 20px 0; overflow: hidden;}.gallery-item { float: left; width: 30%; margin-right: 3%; margin-bottom: 15px;}.gallery-item img { width: 100%; height: auto; border: 1px solid #dddddd;}.image-caption { font-size: 12px; color: #666666; text-align: center; margin-top: 5px; font-style: italic;}/* 清除浮动 */.clearfix:after { content: \".\"; display: block; height: 0; clear: both; visibility: hidden;}/* 页脚 */.newspaper-footer { text-align: center; padding: 15px; background-color: #f5f5f5; font-size: 12px; color: #666666; border-top: 1px solid #dddddd; margin-top: 30px;}

4、编写PdfGenerator类

package com.powerbridge.pbplatformcarouteserver.utils;import java.io.File;import java.io.FileOutputStream;import java.io.IOException;import java.io.OutputStream;import java.nio.file.Files;import java.nio.file.Path;import java.nio.file.Paths;import java.util.Map;import org.thymeleaf.TemplateEngine;import org.thymeleaf.context.Context;import org.thymeleaf.templateresolver.FileTemplateResolver;import cn.hutool.json.JSONUtil;import io.woo.htmltopdf.HtmlToPdf;import io.woo.htmltopdf.HtmlToPdfObject;public class PdfGenerator { private final String templateDir; private final TemplateEngine templateEngine; public PdfGenerator(String templateDir) { this.templateDir = templateDir.endsWith(File.separator) ? templateDir : templateDir + File.separator; this.templateEngine = initializeTemplateEngine(); } private TemplateEngine initializeTemplateEngine() { FileTemplateResolver templateResolver = new FileTemplateResolver(); templateResolver.setPrefix(this.templateDir); templateResolver.setSuffix(\".html\"); templateResolver.setTemplateMode(\"HTML\"); templateResolver.setCharacterEncoding(\"UTF-8\"); templateResolver.setCacheable(false); TemplateEngine engine = new TemplateEngine(); engine.setTemplateResolver(templateResolver); return engine; } public void generatePdfFromTemplate( String templateName, Map context, String outputPath, String[] cssFiles) throws IOException { // Process the template with Thymeleaf Context thymeleafContext = new Context(); thymeleafContext.setVariables(context); String processedTemplateName = templateName.endsWith(\".html\") ?  templateName.substring(0, templateName.length() - 5) :  templateName; String renderedHtml = templateEngine.process(processedTemplateName, thymeleafContext); // Generate PDF try (OutputStream outputStream = new FileOutputStream(outputPath)) {// ITextRenderer renderer = new ITextRenderer(); Path basePath = Paths.get(templateDir).toAbsolutePath(); // Add CSS if provided - CORRECTED APPROACH if (cssFiles != null) { for (String cssFile : cssFiles) {  File css = new File(cssFile);  if (css.exists()) { // Correct way to add CSS - embed it directly in the HTML renderedHtml = renderedHtml.replace(\"\", \"\" + new String(Files.readAllBytes(css.toPath())) + \"\");  } } // Re-set the document with CSS included System.out.println(renderedHtml); boolean success = HtmlToPdf.create()  .object(HtmlToPdfObject.forHtml(renderedHtml))  .convert(outputPath); } } catch (Exception e) { throw new IOException(\"Failed to generate PDF: \" + e.getMessage(), e); } }}

6、测试main函数

 public static void main(String[] args) { try { String worksPath=\"E:/HtmlToPdf/\"; PdfGenerator generator = new PdfGenerator(worksPath); String context = \"{\\\"newspaper_name\\\":\\\"每日新闻\\\",\\\"issue_number\\\":\\\"1024\\\",\\\"issue_date\\\":\\\"2025年07月17日\\\",\\\"editor_in_chief\\\":\\\"王主编\\\",\\\"current_year\\\":2025,\\\"contact_info\\\":{\\\"address\\\":\\\"北京市朝阳区新闻大厦18层\\\",\\\"phone\\\":\\\"010-12345678\\\",\\\"email\\\":\\\"info@dailynews.com\\\"},\\\"headline_news\\\":{\\\"title\\\":\\\"国家发布新一代人工智能发展规划\\\",\\\"reporter\\\":\\\"张科技\\\",\\\"time\\\":\\\"今天 08:15\\\",\\\"image\\\":\\\"E:\\\\\\\\HtmlToPdf\\\\\\\\templates\\\\\\\\assets\\\\\\\\images\\\\\\\\headline.jpg\\\",\\\"content\\\":\\\"\\\\n 
国务院近日印\\\\r\\\\n发《新一代人工智能发展规划》，提出到2030年使中国人工智能理论、技术与应用总体达到世界领先水平，成为世界主要人工智能创新中心。
\\\\n 
规划明 \\\\r\\\\n确了我国新一代人工智能发展的战略目标：到2020年人工智能总体技术和应用与世界先进水平同步；到2025年人工智能基础理论实现重大突破；到2030年人工智能理论、技术与应\\\\r\\\\n用总体达到世界领先水平。
\\\\n 
规划还提出建立开放协同的人工智能科技创新体系，培育高端高效的智能经济，建设安全便捷的智能社会等六大重点任务 \\\\r\\\\n。
\\\\n \\\"},\\\"regular_news\\\":[{\\\"title\\\":\\\"本市地铁新线路今日开通试运营\\\",\\\"reporter\\\":\\\"李交通\\\",\\\"time\\\":\\\"今天 07:30\\\",\\\"image\\\":\\\"E:\\\\\\\\HtmlToPdf\\\\\\\\templates\\\\\\\\assets\\\\\\\\images\\\\\\\\subway.jpg\\\",\\\"content\\\":\\\"\\\\n  
经过四年建设，本市地铁14号线西段今日正式开通试运营。该线路全长16.5公里，设站8座，连\\\\r\\\\n接了多个商业区和居民区，将极大缓解西部城区的交通压力。
\\\\n  
地铁运营公司表示，试运营初期发车间隔为6分钟，未来将根据客流情况逐步缩短间\\\\r\\\\n隔时间。首班车时间为5:30，末班车时间为23:00。
\\\\n \\\"},{\\\"title\\\":\\\"夏季旅游旺季来临 景区推出多项优惠\\\",\\\"reporter\\\":\\\"赵旅游\\\",\\\"time\\\":\\\"昨天 18:45\\\",\\\"content\\\":\\\"\\\\n  
随着暑期来临，我市各大旅游景区迎来旅游旺季。为吸引游客，多家景区推出门票优惠活动。
\\\\n  
其\\\\r\\\\n中，著名5A级景区长城从即日起至8月31日，对全日制学生实行半价优惠；本市居民凭身份证可享受8折优惠。此外，多家景区还推出了夜游项目，丰富游客体验。
\\\\n \\\\r\\\\n \\\"}],\\\"special_report\\\":{\\\"title\\\":\\\"乡村振兴战略实施五周年成果展\\\",\\\"content\\\":\\\"\\\\n 
今年是乡村振兴战略实施五周年。五年来，我市农村面貌\\\\r\\\\n发生显著变化，农民收入持续增长，农业现代化水平明显提高。
\\\\n 
据统计，五年来我市农村居民人均可支配收入年均增长8.5%，高于城镇居民收入增速 \\\\r\\\\n；农村基础设施显著改善，所有行政村实现通硬化路、通宽带；特色农业发展迅速，形成了一批知名农产品品牌。
\\\\n 
下一步，我市将重点推进乡村产业 \\\\r\\\\n振兴、人才振兴、文化振兴、生态振兴和组织振兴，让农村成为安居乐业的美丽家园。
\\\\n \\\",\\\"images\\\":[{\\\"url\\\":\\\"E:\\\\\\\\HtmlToPdf\\\\\\\\templates\\\\\\\\assets\\\\\\\\images\\\\\\\\country1.jpg\\\",\\\"caption\\\":\\\"美丽乡村建设成果\\\"},{\\\"url\\\":\\\"E:\\\\\\\\HtmlToPdf\\\\\\\\templates\\\\\\\\assets\\\\\\\\images\\\\\\\\country2.jpg\\\",\\\"caption\\\":\\\"现代化农业大棚\\\"},{\\\"url\\\":\\\"E:\\\\\\\\HtmlToPdf\\\\\\\\templates\\\\\\\\assets\\\\\\\\images\\\\\\\\country3.jpg\\\",\\\"caption\\\":\\\"乡村旅游新业态\\\"}]}}\"; Map contextObj = JSONUtil.parseObj(context,true).toBean(Map.class,true); generator.generatePdfFromTemplate( \"templates/newsjava.html\", contextObj, worksPath+\"/daily_news_java.pdf\", new String[]{worksPath+\"templates/assets/css/news.css\"} ); } catch (Exception e) { System.err.println(\"Error generating PDF:\"); e.printStackTrace(); } }

注意：1、如果直接cp上面的代码，需要在windows 系统的E盘下逐层创建 “E:\\HtmlToPdf\\templates\\assets\\css\\”目录，并将上面的css 样式代码贴到当前目录新建的news.css文件。

2、逐层创建“E:\\HtmlToPdf\\templates\\assets\\images\\”目录并在其目录下存入对应图片文件

3、逐层创建“E:\\HtmlToPdf\\templates\\”目录并在其目录下创建名为“newsjava.html”的模板文件并将上面的HTML 内容贴到里面

6、修改PdfGenerator 类头的package com.powerbridge.pbplatformcarouteserver.utils;引用即可。

7、将上面的main函数直接贴到PdfGenerator中即可运行