You need to enable JavaScript to run this app. Thymeleaf+Spring Boot导出PDF时从MySQL读取的Base64图片不显示
优惠活动
大模型
产品
解决方案
定价
更多

Thymeleaf+Spring Boot导出PDF时从MySQL读取的Base64图片不显示

你遇到的问题核心是Flying Saucer(ITextRenderer所属的框架)对Base64内嵌图片的容错能力远低于普通浏览器,主要触发原因有两个:

  1. Base64字符串中存在多余空格,浏览器会自动忽略,但ITextRenderer会直接识别为无效编码
  2. 默认版本的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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.15 10:54:04