开发与 QA 检查清单
发送前、到达后,把测试邮件逐项验清
一封邮件“能收到”还不够。用这份清单同时检查业务触发、收件身份、内容层级、行动入口、时序、失败路径和隐私边界,让发布结论可复现。
覆盖范围
六组检查,组成一次完整回归
卡片不是静态装饰。按测试顺序从左到右执行,任何阻断项失败都不应只靠“再发一次”放行。
2. 触发与投递
3. 主题与预览
4. 正文与行动
5. 验证码与安全
6. 兼容与收尾
身份和触发条件要能复现
测试前先写清“谁在什么状态下做了什么动作”,并列出应该发送和不应该发送的条件。只测成功路径会漏掉通知偏好关闭、账户已验证、重复事件去重等重要分支。
收件地址应从当前测试工具栏复制,避免手工输入。换地址后要同步更新测试用户,旧信件不会迁移,新旧地址混用会让结果失去可信度。
验证码与重置链接需要成组测试
检查代码长度、字符集、有效期、使用一次后失效和重发规则。页面说 10 分钟而后端 5 分钟过期,属于业务缺陷,不是文案小问题。
同时验证错误代码、过期代码、连续输入和频繁重发的反馈。链接式验证要核对协议、主机名、环境、一次性令牌和跳转后的最终页面,不能只确认按钮能点击。
HTML、图片和纯文本分别检查
在邮件正文中确认容器宽度、标题换行、按钮高度、段落间距和图片缩放。长姓名、长项目名、法语或葡语按钮比中文更容易撑破布局,应使用最长合理样本回归。
关闭图片后,品牌和核心任务仍应可辨认;纯文本版本应保留验证码、期限、链接和支持信息。不要把所有内容塞进图片,也不要让隐藏预览文本出现在正文首行。
链接、附件和回复行为不能只看外观
逐个打开主按钮、次要链接、帮助入口和退订入口,确认目标域、路径、参数与登录状态正确。测试环境链接不应误指生产写操作,生产模板也不应带测试域。
附件要核对文件名、类型、大小和权限;危险类型应被阻止或隔离。回复邮件时检查 Reply-To 是否进入预期支持渠道,避免回复到无人监控的发信地址。
语言、时区和无障碍保持一致
主题、预览、正文、按钮和错误提示必须是同一语言,日期、金额和时区按用户地区格式化。缺失翻译时应使用受控兜底,而不是在一封邮件中随机混合语言。
标题层级应连续,链接文字要描述目的,图片应有合适替代文本。颜色不能是表达状态的唯一手段,浅色文字在白底和深色文字在彩底都要有足够对比。
失败、延迟和重复也是产品体验
模拟队列延迟、服务商临时拒绝和永久退信,观察是否按策略重试并避免重复通知。用户界面应给出可操作状态,而不是把所有失败都写成“网络错误”。
若测试邮件未到达,沿应用、队列、发送平台、DNS 和接收端证据逐层诊断。保留首次失败证据,再验证修复,不要因为某次重发成功就删除原始线索。
发布门槛按风险分级
| 级别 | 示例 | 发布门槛 | 失败处理 |
|---|---|---|---|
| 阻断 | 邮件未生成、目标错、验证码不可用、主链接错误 | 必须全部通过 | 停止发布并修复根因 |
| 高 | 重复发送、期限不一致、移动端正文裁切 | 需修复或由负责人书面接受 | 建立明确期限和回归用例 |
| 中 | 预览重复、次要链接标签不清、长文本换行差 | 评估受众与频率 | 进入最近迭代并保留证据 |
| 低 | 不影响任务的轻微视觉偏差 | 不阻断核心流程 | 记录模板与客户端范围 |
把检查结果变成可追踪证据
记录用例编号、环境、模板版本、语言、收件地址前缀、触发和到达时间、消息 ID、结果与缺陷链接。截图应覆盖主题和关键正文,但要遮蔽令牌与真实个人数据。
修复后用同一条件回归,并补测最接近的失败路径。若需要帮助定位投递问题,可使用邮件送达诊断指南或联系 support@msgtmp.com。