使用html/template解析SAAS项目邮件模板时HTML无法解析

嘿，我懂你开发SaaS项目时碰到的这个邮件模板解析难题——用html/template处理带{{.TOKENNAME}}格式令牌的模板，结果HTML解析出问题，确实挺闹心的。咱们一步步拆解可能的原因和解决办法：

先排查最容易踩的坑：字段匹配与可访问性 #

Go的模板引擎对结构体字段的大小写非常敏感，而且只有**首字母大写的字段（可导出字段）**才能被模板访问到。你定义的EmailTemplate里BookingDetails是大写开头，这点没问题，但要确保模板里的令牌和字段名完全一致——比如模板里写{{.bookingdetails}}（小写开头）就会匹配失败，导致内容无法替换。

核心问题：HTML内容被自动转义 #

html/template默认会对所有动态内容做HTML转义，防止XSS攻击，但这也会导致你原本的HTML标签变成纯文本显示（比如<strong>会被转成<strong>）。解决这个问题有两种方式：

方式1：用template.HTML类型标记安全内容

把结构体中存储HTML内容的字段类型改成template.HTML，告诉模板引擎这段内容是安全的HTML，不需要转义：

import "html/template"

type EmailTemplate struct {
    BookingDetails template.HTML // 标记为安全HTML
}

// 使用时直接传入包含HTML的内容
data := EmailTemplate{
    BookingDetails: template.HTML("<strong>您的预订ID：12345</strong><br>入住日期：2024-06-01"),
}

方式2：在模板中使用safeHTML过滤器

如果不想修改结构体类型，可以在模板里给字段加上过滤器，明确允许HTML渲染：

<!-- 邮件模板内容 -->
<h1>预订确认通知</h1>
<p>{{.BookingDetails | safeHTML}}</p>

别忽略错误处理！ #

很多时候解析失败的原因藏在错误信息里，但如果代码里没捕获Parse和Execute的错误，就很难定位问题。一定要加上错误日志：

import "log"
import "bytes"

// 解析模板
tmpl, err := template.New("email-template").Parse(yourTemplateString)
if err != nil {
    log.Printf("模板解析失败: %v", err)
    return
}

// 执行模板到缓冲区
var buf bytes.Buffer
err = tmpl.Execute(&buf, yourTemplateData)
if err != nil {
    log.Printf("模板执行失败: %v", err)
    return
}

// 赋值到EmailRequest
emailReq := EmailRequest{
    EmailTo: "customer@example.com",
    EmailBody: buf.String(),
}

额外注意：避免手动修改模板字符串 #

如果你的代码里有手动替换令牌的逻辑（比如先用字符串替换再交给模板解析），很可能破坏模板的语法结构（比如动态内容里包含{{或}}）。所有动态内容都应该通过模板上下文传递，不要手动修改模板原文。

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