Thymeleaf+Spring Boot导出PDF时从MySQL读取的Base64图片不显示
你遇到的问题核心是Flying Saucer(ITextRenderer所属的框架)对Base64内嵌图片的容错能力远低于普通浏览器,主要触发原因有两个:
- Base64字符串中存在多余空格,浏览器会自动忽略,但ITextRenderer会直接识别为无效编码
- 默认版本的Flying Saucer没有内置data URI协议的解析器,无法识别base64格式的内嵌资源
解决步骤
1. 清理所有多余空格
- 后端拼接Base64前缀时,移除逗号后的多余空格,
base64推荐统一小写避免兼容问题:
// 修改前 // String pic = "data:image/jpeg;Base64, " + Base64.encodeBase64String(dBFiles.get(1).getData()); // 修改后 String pic = "data:image/jpeg;base64," + Base64.encodeBase64String(dBFiles.get(1).getData());
- 修复Thymeleaf模板中
${pic}后的多余空格:
<!-- 修改前 --> <!-- <img th:src="${pic} " alt="hey" name="images" width="300"></img> --> <!-- 修改后 --> <img th:src="${pic}" alt="hey" name="images" width="300"></img>
2. 为ITextRenderer添加Base64资源解析器
如果清理空格后仍无法显示,需要手动实现支持data URI的解析器,添加到渲染器中,完整后端代码修改如下:
List<DBFile> dBFiles = fileService.getFilesByPaziente(username); String pic = "data:image/jpeg;base64," + Base64.encodeBase64String(dBFiles.get(1).getData()); variables.put("pic", pic); context.setVariables(variables); String html = templateEngine.process("pazienti/pdf_scheda_template", context); String outputFolder = System.getProperty("user.home") + File.separator + "thymeleaf.pdf"; OutputStream outputStream = new FileOutputStream(outputFolder); ITextRenderer renderer = new ITextRenderer(); // 添加Base64解析支持 renderer.getSharedContext().setUserAgentCallback(new ITextUserAgent(renderer.getOutputDevice()) { @Override public InputStream getInputStream(URI uri) throws IOException { if (uri.getScheme().equals("data")) { String data = uri.getSchemeSpecificPart(); String[] parts = data.split(","); if (parts.length == 2 && parts[0].contains("base64")) { byte[] bytes = Base64.decodeBase64(parts[1]); return new ByteArrayInputStream(bytes); } } return super.getInputStream(uri); } }); renderer.setDocumentFromString(html); renderer.layout(); renderer.createPDF(outputStream); outputStream.close();
兜底兼容方案
如果上述方案仍不生效,可以将Base64图片临时写入本地磁盘,把本地文件路径传给Thymeleaf模板,PDF生成完成后删除临时文件即可,该方案对所有版本的Flying Saucer都兼容。
内容的提问来源于stack exchange,提问作者Anis Saidani
相关产品推荐
相关产品推荐

