这篇写给做社区/论坛、正把「能用」推进到「有人用」的开发者,以及负责运营工具和移动端的同学;下面这张表按角色列出你能带走什么、从哪节开始读。
| 读者 | 带走什么 | 拿它做什么 | 从哪节开始读 |
|---|---|---|---|
| 做社区的人 | 滚动窗口告警规则 | 直接照搬「2 小时 3 条」到自己的反馈区 | 4 |
| 写运维工具的人 | 状态文档 + 邮件日志两层去重清单 | 抄成自己告警的防重复实现 | 4 |
| 负责移动端的人 | 移动端验收标准 | 用「导航全部可点 + 无横向滚动」当验收线 | 5 |
只做纯前端样式、不碰运营链路的读者不必读。
这篇讲一个论坛上线之后的三件事:补导航入口、给 bug 反馈划出唯一归属、做第一版「玩家集中报 bug 时半小时内知道」的运营告警,最后修移动端头部。先看概览,决定从哪节读起:
| 小节 | 讲什么 | 读它能得到什么 |
|---|---|---|
| 1 | 背景:能用之后缺的是被看见 | 判断自己缺哪条运营链路 |
| 2 | 导航:加一个入口而不是一堆 | 一条「少而稳」的导航原则 |
| 3 | bug 分区与归属标准 | 一张告警统计标准表 |
| 4 | 滚动窗口告警与两层去重 | 可直接照搬的告警流程 |
| 5 | 移动端头部第一版 | 一条可验收的移动端标准 |
| 6 | 坑表与下一步 | 排查对照表 |
论坛本身已经上线,发帖、回复、分区都能跑。它跑在 CloudBase(腾讯云的云开发,一套无服务器云服务:不用买服务器,把前端文件传上去就能访问,同时提供云数据库和云函数)上;帖子存在云数据库的集合(类似一张表,里面每条是一个文档)里,邮件与定时逻辑跑在云函数(按需执行、不用自己开服务器的函数)里。
上线后暴露的不是功能缺失,而是两条运营链路断了:首页导航没有「关于开发者」这类入口,访客找不到;玩家在 bug 分区反馈问题,如果我不主动刷,帖子可能躺一整天。所以这一版的目标很朴素:玩家集中报 bug 时,我要在半小时内知道。
为什么做:论坛访客大多是来玩游戏的,他们需要知道游戏是谁做的、还能去哪找作者;这个信息不该藏在页脚。怎么做:只新增「关于开发者」入口,中英文各一份。有什么好处:导航「少而稳」——每多一个链接,移动端横向空间就紧一分,后面的适配问题会被放大。
为什么做:bug 分区把「能复现的问题」和「闲聊」分开,它决定告警读哪批帖子。怎么做:按 createdAt(发帖时间)归属——发帖时在哪个分区就永远算哪个分区,不按当前分区查;管理员自己发的帖子不计入统计。为什么这样做:告警统计的是「某段时间内产生的 bug 反馈」,不是「当前看起来像 bug 的帖子」;不排除管理员,测试时会自己给自己发告警。
为什么做:玩家集中反馈时,半小时内要知道。规则:滚动 2 小时内,bug 分区出现 ≥3 条玩家新帖,就发一封管理员邮件;同一个窗口最多打扰一次。
这里的「桶」指时间桶——把连续时间切成固定长度的区间(整点桶就是 00:00–01:00、01:00–02:00 这样切),告警按桶记账。为什么用「滚动窗口」而不是「整点窗口」:整点窗口会出现 1:59 和 2:01 各两条的情况——五分钟内的集中反馈跨了整点,两个窗口各两条,谁都不触发。
本地调试需要 Node 18 与项目依赖(npm install);告警跑在既有的 forum-mailer 云函数(论坛的邮件发送函数)里,不需要新建服务。
怎么做:全部落在既有的 forum-mailer 里,靠一个 timer 分支调度。下面这段是它的执行顺序(伪代码,带行号便于讨论,省略了具体查询语句):
1 │ timer(每 30 分钟)
2 │ → 解析配置(非法值降级,不阻断)
3 │ → 检查邮件通道就绪
4 │ → 只发 admin,不兜底 config.to(防止运维邮件误入用户信箱)
5 │ → 按下推时间查 bug 分区帖子(createdAt > 窗口起点)
6 │ → 过滤:滚动窗口内 + 非管理员 + createdAt 归属
7 │ → 读状态文档(lastBucket + 已告警帖子 ID)
8 │ → 桶级查重(docId = bug_alert_<tag>_<bucketKey>)
9 │ → 只统计尚未告警过的新帖
10 │ → 数量 ≥ 阈值 → 限流校验 → 渲染模板 → claim 邮件日志 → 发送
11 │ → 成功后回写状态(lastBucket + 合并帖子 ID + 清理滑出窗口的条目)
好处与细节:去重落在两层,下面这张表是两层各自的职责:
| 层次 | 记在哪 | 防的是什么 |
|---|---|---|
| 状态文档 | 该桶是否告过警(lastBucket + 帖子 ID) | 重复打扰 |
| 邮件日志 | 按文档 ID(docId)幂等——同一个 ID 只允许一封 | 并发重复发送 |
另外三条(幂等=同一操作重复执行,结果一样;这里靠状态文档和邮件日志的 ID 两层保证):时钟回拨不补发(算出的桶比 lastBucket 老就跳过,宁可不发);查询要分页(skip + limit 循环,否则帖子一多就静默漏统计);发帖链路零改动(告警完全跑在读侧,运营工具不能成为发帖失败的新原因)。邮件模板是纯函数:输入窗口起止、帖子列表和配置,输出主题和正文,可以单测、不用真发信。
为什么做:截图上一眼可见——导航被挤到第二行看不见,搜索框占满整个宽度。怎么做:头部从「一行硬塞」改成按断点分行的网格:窄屏时论坛导航进首行,两个站的搜索框折叠成图标;再窄一点退成两行网格,保证导航完整可见,头部左右内缩与内容对齐。好处:不做完整响应式体系,只解决「看不全」这一个具体问题。验收标准:在手机宽度下,所有导航项都能点到,且不需要横向滚动。
下面按「是什么 → 为什么是坑 → 怎么解决 → 为什么能解决」排:
| 坑是什么 | 为什么是坑 | 如何解决 | 为什么能解决 |
|---|---|---|---|
| 用整点窗口统计 | 1:59 与 2:01 的集中反馈各落一个窗口,谁都不触发 | 改滚动窗口 | 窗口跟着「最近 2 小时」滑动,不受整点切分 |
| 只做一层去重 | 并发时同一窗口发两封邮件 | 状态文档 + 邮件日志 docId 两层 | 一层管是否打扰,一层管是否真的发出 |
| 告警查询不分页 | 数据库单次查询有上限,帖子一多静默漏统计 | skip + limit 循环 | 每页读满再读下一页,不漏也不重 |
| 把告警写进发帖链路 | 告警一挂,发帖跟着失败 | 告警只跑在读侧 | 写路径不新增依赖,故障面不扩大 |
你下一步能做什么:先给你的反馈入口定一个归属标准(按发帖时间还是当前分类),再把告警写成「滚动窗口 + 两层去重 + 分页」三件套,最后用手机宽度点一遍所有导航项、确认没有横向滚动。
这些内容来自一个真实社区站点上线后几周的运营补课:导航入口、反馈分区、告警与移动端布局一处一处补,每处都踩过坑再修。文中的时间窗口、条数阈值与行数都是当时实测的结果。