《互联网产品的客户端架构·内容、社交与实时互动》11.1 端上预检:能拦什么、不能拦什么
端上预检只能做早反馈,不能替代审核。本节用纯函数实现长度、格式、控制字符与少量高风险词的本地提示,区分硬阻断、可申诉复核与轻提示三类结果,给出带允许短语、零宽归一化和规则版本的 8 条测试,并复盘一次单字黑名单误拦「黄金周」正常游记的事故。
category
端上预检只能做早反馈,不能替代审核。本节用纯函数实现长度、格式、控制字符与少量高风险词的本地提示,区分硬阻断、可申诉复核与轻提示三类结果,给出带允许短语、零宽归一化和规则版本的 8 条测试,并复盘一次单字黑名单误拦「黄金周」正常游记的事故。
从《互联网产品的服务端架构》与《互联网产品的客户端架构》结束的地方出发,说明为什么把模型接进产品会变成一个架构问题:能力契约、网关边界、失败语义、降级与计量缺一不可;并交代本卷的四个判断、适用读者、与站内专题的分工,以及代码、版本与数字口径。
《互联网产品的 AI 架构·模型接入与能力边界》全 45 篇:13 章正文覆盖能力契约、模型选型、网关、路由、流式、提示、结构化输出、预算、缓存、降级、安全与观测;附序、前言、目录与三篇附录,配可运行的 TypeScript 实验工程,可直接按章跳读。
以 arch-lab 订单系统为例,用实例、可用区、依赖与数据副本的结构化拓扑实现单点检查器,枚举组件、数据与依赖三类 SPOF,计算可用区失效后的容量覆盖与 N+1 剩余容量,并用表驱动测试覆盖单实例、同区双实例与跨区副本等五种典型拓扑案例。
实现订单接口的幂等存储与 Guard:键、请求指纹、PROCESSING/DONE/CONFLICT、结果快照与过期窗口;用故障注入和 -race 真跑并发同键、同键不同参数、处理中崩溃重试与窗口过期,证明重复请求不会二次扣库存或二次支付,并给出存储不可用时的失败关闭策略。
把客户端、网关、服务三层重试建成放大模型,实现指数退避与 full jitter,并在同一故障序列下真跑 1000 个请求:总请求同为 1737、放大 1.737 倍,无抖动重试峰值 495,full jitter 峰值 11;另给出重试预算、幂等前提和不可重试错误清单。
推送不是「有没有」的二值问题:权限被拒、系统通知关闭、令牌失效,三种情况的恢复路径完全不同。本节给出推送降级矩阵、打开应用时的补偿同步策略与「旧推送角标不能覆盖新已读」的规则,并用 TypeScript 实现计划器与角标合并,复盘一次关掉通知的用户永远看不到红点的事故。
在 1.3 的预算分配器之上实现服务端超时中间件:解析请求头预算、设置绝对 deadline、向下游传递扣减后的剩余预算并回写实际耗时;用 httptest 真跑两跳扣减和每跳新建超时的对照,实测 300ms 链路转发 267ms、总耗时 302ms 与 343ms。
同一个「已读」布尔值在两台设备之间一定会打架:甲读完 3 条,乙把整个会话标成已读,新消息到达后两边都显示已读。本节把已读建模为按会话单调前进的位置,用最大位置合并多端状态,处理回执失败重试与服务端总数覆盖,并复盘一次无位置回执把新消息误标已读的事故。
在 arch-lab 订单链路上实现可组合的降级策略链:订单查询按快照、默认值、只读顺序兜底,支付回调把验签、金额、幂等落账列为不可降级步骤,只有下游暂时不可用才进入持久队列稍后重试;用契约测试证明降级响应仍合法、快照落后于已提交版本时必须显式报错而不能掩盖不一致,并给出错误码、用户文案与恢复后的补偿动作。
点赞、评论、关注与系统通知四种来源的未读数,为什么不能用一个 total += 1 维护。本节用服务端水位 ackSeq 与事件 id 划清「已计数」和「端上待确认」,给出按类型分组、99+ 上限与幂等合并的 TypeScript 实现,并复盘一次旧快照把角标从 4 覆盖回 3 的线上问题。
拉黑是安全操作,端上必须先隐藏再同步:信息流、详情、评论、搜索、私信五处都要在请求发出前生效。本节实现 pending/active/failed 三态 BlockStore、失败不回显的重试、只增不减的服务端快照合并,并复盘一次等确认导致弱网下仍能看到对方内容的事故。
在 arch-lab 支付下游实现 closed/open/half-open 三态熔断器:用时间滑窗成功率与慢调用率触发打开,半开阶段限制并发探测配额并在探测失败时立即重开;给出并发状态迁移测试、20 并发只放 3 个探测的真实输出,以及支付链路阈值、误熔断代价和强制打开/关闭的运维入口。
可见性规则在端上只能表达为提示与预判,最终仍以服务端为准。本节把公开、关注可见、好友可见、仅自己可见映射为带置信度的预判,给出可测试的首屏骨架、服务端纠正、拒绝后清理缓存与受众提示的完整实现,并复盘一次预判过宽导致缓存标题与封面提前泄露的事故。
关注、粉丝与互关不是一张布尔表:方向、新鲜度和进行中的变更都要分别记录。本节用带假时钟的 FollowCache 实现四态关系缓存、TTL 降级、乐观关注与回滚,给出关系变化后的列表失效矩阵,并复盘一次把缓存互关当成私信授权、导致错误入口的事故。
在 arch-lab 订单链路上实现令牌桶与精确滑动窗口限流器,用注入时钟重放同一到达序列,对照放行数、突发容忍与窗口误差;再实现带 TTL 的分布式租约,用确定性模拟量化时钟漂移造成的配额浪费、拒绝率与跨实例不均,并给出下单、支付回调的限流参数与运维边界。
在 arch-lab 下单链路实现带 deadline 的调用包装、在途取消与慢调用统计,用 240 个请求和 300ms 慢下游真实复现“连接堆积→队列打满→上游超时”:修复前 240 次网关超时、96 次提交阻塞,修复后均为 0,并给出网关、服务、下游三层指标与取消边界。
在 arch-lab 订单服务上给库存、支付、通知三个下游分别实现信号量舱壁与令牌桶配额,用真实测试证明支付被拖慢时库存与通知仍在 18ms 内完成,并给出按 Little 定律计算并发配额、OVERLOADED/RATE_LIMITED 错误码与舱壁过小的退出条件。
在线状态一旦涉及隐私,就不再是「显示什么」,而是「允许谁看到什么证据」。本节把可见性、关系、拉黑与连接降级组合成一张展示决策表,明确 unknown 与 offline 的差别,给出可运行实现与测试,并复盘一次隐藏在线后仍能从活跃时间反推的事故。
在 arch-lab 订单服务上实现有界工作池与连接池租约模型:队列上限、等待超时、三种拒绝策略、在途与排队指标、泄漏检测;用 1200 个任务真实对比 1/4/16/64 个 worker 的吞吐与排队,并给出 Java 21 线程池对照、本机命令与原始输出。