前言
今晚在后台翻评论时,看到两条几乎相邻的留言:
- 同一个邮箱,两个昵称。
- 第一条昵称是「阿远」,语气像老读者,接着上一篇的话题继续聊;
- 第二条昵称是「远哥」,内容正常,却像是另一个人。
系统却把它们算作同一个人:头像相同,读者页合并,资历标签从「新朋友」直接变成「回头客」,回复通知也都进了同一个收件箱。
那一刻,我突然意识到:我的博客一直没有真正的「评论者身份」。它只有昵称和一条随手填的邮箱。
于是动手改动了一些逻辑,下面详细记录整个过程,供小伙伴们参考。
一、问题不在昵称,而在身份
最初的评论功能设计很简单:
- 昵称:用户自行填写;
- 邮箱:用于收通知,头像通过 Gravatar/QQ 哈希获取。
随着功能逐步完善,出现了以下需求:
- 读者页按人聚合留言;
- 排行榜统计「谁来得最勤」;
- 回复邮件需要称呼对方;
- 评论展示「新朋友 / 回头客 / 常客」标签;
- 后台判断评论是否为博主本人。
这些需求都在问同一个问题:这个人是谁?
当时的答案仅是 author 字段,导致同一邮箱换昵称后出现一系列矛盾现象:
| 位置 | 看到的结果 |
|---|---|
| 评论列表 | 两个不同的昵称,像两个人 |
| 头像 | 同一个头像,像同一个人 |
| 读者页 | 合并成一个读者,名字取最近一条评论 |
| 资历标签 | 按邮箱累计,第二次就显示「回头客」 |
| 回复邮件 | 发给同一个邮箱,但称呼的是当时那条评论的昵称 |
更麻烦的是,昵称和邮箱都没有验证,任何人填一个邮箱都能评论,随意换昵称就能变成「另一个人」。
根本问题:从未认真定义「邮箱、昵称、读者」三者的关系。
二、我想要的规则
- 邮箱是身份,昵称是展示名——同一个邮箱就是同一个读者,昵称可以变但身份不变。
- 首次评论自由,后续改名要付一点成本——第一次随意取名,改名需要邮箱验证。
- 所有展示口径必须统一——评论区、读者页、排行榜、邮件称呼保持一致。
- 身份可信,不等于内容可信——邮箱验证只能证明「这个邮箱是你的」,不能证明「这条评论没问题」,内容仍需审核。
三、第一版想法:把昵称锁死
最粗暴的方案是:同一个邮箱第一次填的昵称以后固定不变。
实现简单:查询邮箱哈希,有记录就把 author 覆盖成历史昵称。
但我很快否掉了,因为:
- 人会变:中二昵称想换真名;马甲想重新开始;打错字想改正。
- 锁死改名会导致用户换邮箱,导致读者页、资历、历史留言全部断裂,甚至比「一人多名」更糟。
结论:需要允许改名,但改名必须可追溯、可验证。
四、最终方案:确认 + 验证
1. 提交评论前的身份检测
前端在提交前请求后端:
GET /api/comment/identity?email=test@example.com&author=新昵称
后端返回三种情况:
- 无记录:首次评论,直接放行。
- 昵称一致:老读者,直接放行。
- 昵称不一致:返回冲突,前端弹窗提示。
2. 弹窗提供两种选择
检测到该邮箱之前使用过昵称「阿*」。
- 继续使用原昵称
- 修改为新昵称(需要邮箱验证)
曾用名会打码,防止泄露隐私。
3. 继续使用原昵称
用户点击「继续使用原昵称」后,前端提交隐藏字段 identity_confirmed=1。后端不信任前端传来的昵称,而是直接查询身份表,将作者名覆盖为当前昵称。
4. 修改昵称:邮箱验证码流程
- 点击「发送验证码」;
- 后端生成 6 位数字,存哈希并发送邮件;
- 用户输入验证码;
- 验证通过后签发一次性 token(5 分钟有效);
- 提交评论时携带 token;
- 后端校验 token 与邮箱、昵称匹配后才允许改名。
改名成功后,系统会:
- 更新身份表的
current_author; - 同步更新该邮箱下所有历史评论的
author字段。
这样读者页、排行榜、评论列表、邮件称呼都保持统一。
五、数据表设计:把「身份」单独抽出来
1. 评论者身份表 comment_identities
CREATE TABLE comment_identities (
email_hash TEXT PRIMARY KEY,
email TEXT NOT NULL,
current_author TEXT NOT NULL,
previous_author TEXT DEFAULT '',
verified_at TEXT DEFAULT '',
created_at TEXT NOT NULL,
updated_at TEXT NOT NULL
);
email_hash与评论表中的哈希保持一致。- 身份是长期的,评论是一次性的,分表有助于维护历史记录。
2. 邮箱验证码表 email_codes
CREATE TABLE email_codes (
id INTEGER PRIMARY KEY AUTOINCREMENT,
email_hash TEXT NOT NULL,
email TEXT NOT NULL,
code_hash TEXT NOT NULL,
new_author TEXT NOT NULL,
purpose TEXT NOT NULL,
expires_at INTEGER NOT NULL,
attempts INTEGER DEFAULT 0,
used_at TEXT DEFAULT '',
ip TEXT DEFAULT '',
created_at TEXT NOT NULL
);
- 只存哈希,不存明文。
- 发送新验证码前会删除旧的未使用记录,保证「只有最新一封邮件有效」。
3. 评论表新增字段
ALTER TABLE comments ADD COLUMN identity_action TEXT DEFAULT '';
ALTER TABLE comments ADD COLUMN identity_note TEXT DEFAULT '';
identity_action:first/keep/renameidentity_note:供后台查看的说明
不同来源的数据应分离,避免 AI 审核覆盖 ai_meta 时把身份信息一起抹掉。
六、验证码细节:比想象中更复杂
| 维度 | 限制 |
|---|---|
| 同一邮箱 | 60 秒 1 次 |
| 同一邮箱 | 10 分钟 5 次 |
| 同一邮箱 | 24 小时 10 次 |
| 同一 IP | 1 小时 10 次 |
- 只允许已有评论记录的邮箱发送,防止接口被当成免费邮件发送器。
- 验证码本身:6 位数字、10 分钟有效、最多尝试 5 次、使用后立即作废、哈希存储。
- 邮件模板复用现有的邮件外壳,保持统一的品牌感。
七、改名后统一展示
改名成功后执行一次批量更新:
UPDATE comments
SET author = ?
WHERE email_hash = ?
AND is_owner = 0
AND is_ai = 0;
直接写回评论表可以避免在每个展示点都忘记查询身份表导致的割裂。旧昵称仍保存在 comment_identities.previous_author,后台可查看改名历史。
八、顺手修掉的另一个更危险的问题
在实现上述功能的过程中,我回头审视了原有的审核逻辑,发现了一个潜在的安全漏洞……(后续内容请自行阅读原文)
完
评论 20
大家对于,邮箱评论是如何处理的?可以一起探讨!
验证码将发送到