Thymeleaf：向邮件中添加图片报错，求有效解决方法

问题原因 #

邮件渲染环境没有Web上下文，无法解析/开头的上下文相对路径，也不支持直接通过classpath:链接表达式加载图片，所以会抛出Link base "/resources/images/logo.png" cannot be context relative (/)错误。

可行解决方案 #

方案1：嵌入内联资源（推荐） #

通过Java代码将图片作为邮件内联资源添加，再在模板中引用：

1. Java代码处理：

// 加载classpath下的图片资源
Resource logoResource = new ClassPathResource("images/logo.png");
// 生成唯一内容ID，避免冲突
String contentId = UUID.randomUUID().toString();

// 向模板传递contentId
Context templateContext = new Context();
templateContext.setVariable("logoCid", contentId);

// 渲染邮件模板
String emailHtml = templateEngine.process("your-email-template", templateContext);

// 构建MIME邮件
MimeMessage mimeMsg = javaMailSender.createMimeMessage();
MimeMessageHelper helper = new MimeMessageHelper(mimeMsg, true, "UTF-8");
helper.setTo("target@example.com");
helper.setSubject("邮件标题");
helper.setText(emailHtml, true);

// 将图片添加为内联资源
helper.addInline(contentId, logoResource);

2. Thymeleaf模板引用：

<img th:src="|cid:${logoCid}|" alt="站点Logo" />

方案2：使用公开绝对URL #

如果图片部署在可公开访问的服务器上，直接使用完整URL：

<img src="https://your-domain.com/static/images/logo.png" alt="站点Logo" />

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