### [02.06.020 排查邮件模板修改未生效](https://guaqi.com/docs/77521)

**Published:** 2026-09-11T02:20:31

**Author:** 二丿小青年

**Excerpt:** 一、这个功能能做什么 邮件修改没有生效时，先确认改的是实际发送事件所用的模板和语言。 先认识这几个词 占位符 …

[02 网站设置](/docs-archive/1202) / [02.06 邮件通知](/docs-archive/1209)

## 一、这个功能能做什么

邮件修改没有生效时，先确认改的是实际发送事件所用的模板和语言。

### 先认识这几个词

-   **占位符**：发送或显示时自动替换的标记，例如用站点名称或当前订单号替换。
-   **前端**：访客实际打开和使用的网站；同一后台可以对应多个前端网址。

## 二、设置后会有什么效果

可以分清模板未启用、业务事件没有触发、语言不匹配和发信服务异常，避免只改正文却一直收不到邮件。

## 三、怎么使用

1.  重新打开「邮件模板」，检查值和启用状态。
2.  核对实际事件：验证码、数字交付、游客访问或询盘可能使用不同模板。
3.  核对本次发送请求使用的语言，不要只看后台界面语言。
4.  确认占位符来自当前模板，业务必填数据齐全。
5.  区分没有触发发送、模板渲染失败、服务发送失败与邮箱未送达。

### 正文有变化但链接错误

检查是否将测试链接、订单号写死，或把另一个前端的地址复制过来。保留正确占位符，由业务事件生成当前链接。

### 译文不完整

检查对应语言下的主题和正文。主站语言池、前端启用语言和邮件语言不应被粗略当成一个开关；缺少译文时应核对实际回退结果。

反馈时提供模板名称、业务事件时间、请求语言、收件地址的脱敏形式以及公开报错；不要发送有效的游客订单私密访问链接。

## 四、常见问题

### 模板已经修改，为什么没有收到邮件？

先确认相应模板已启用、业务事件确实触发、语言匹配，再检查发信服务。修改模板只改变适用邮件的内容，不会立即向所有用户发送邮件。



---