模板切换后头部缺失:分层排查与“闸门”
模板/管道更新最容易引入“隐藏回归”:List‑Unsubscribe 丢失、From 被覆盖、MIME 边界异常。把“头部校验”放在 staging gate, 并与上线后 24h 的回归联动,就能第一时间发现。
一键自检
体检会解析 AR 头并检测退订/对齐,避免手工抓包。
Staging gate(合并前必须通过)
- 退订头:
List‑Unsubscribe与List‑Unsubscribe‑Post: List‑Unsubscribe=One‑Click - 对齐:
header.from、smtp.mailfrom、dkim d=的组织域比对 - DKIM:选择器存在、签名通过(测试环境)
上线后 24 小时回归
- 抽样生产报文,解析 AR;对比灰度与全量阶段差异。
- 若“退订头丢失/对齐失败”告警触发,自动回滚模板版本。
- 保留 PDF 证据,贴到变更单。
常见故障与修复
| 症状 | 原因 | 修复 |
|---|---|---|
| 退订头缺失 | 模板拆分/复用漏加 | 统一在渲染层注入两行头部 |
| 对齐失败 | 供应商 d= 或 envelope | 在 DKIM 上对齐 d=brand.tld 或调整发件 envelope |
| DKIM 偶发失败 | 单一选择器/密钥过期 | 双选择器、零停机轮换;密钥 ≥2048 |