3.0 KiB
3.0 KiB
Go-sms 重建设计规范(强制)
【文档状态】🔄 生效(2026-11-12)——C 层踩坑结论的结构化沉淀;任何 v2 设计/评审与本文冲突时,以本文为准(除非有 POC 验收单级的新证据推翻并留痕)。
一、结构裁决
- 以 POC 实际演化结构为基础,不照搬技术方案 §11 纸面结构(35 包 -race 全绿的实测结构 > 纸面设计);
- 修正项:
internal/router空壳归位;send 按受理/消费/下发拆子包;测试命名去 dayNN 改语义;message_detail建表即单表化(v17 口径)+ 按天分区热 5 天; - 服务边界:gateway 大单体拆分评估放 S5 基线期(性能数据齐后裁决),搬运期不强拆。
二、性能三律(Day64/67 三轮优化 82s→1.0s 的代价换来的)
- 筛选列随查询下沉明细表:业务筛选禁止依赖 JOIN task(单表化冗余列);
- 聚合 JOIN 一律改按页 id 的相关子查询:派生表全表物化会随业务量静默劣化(每页请求都付全表聚合代价);
- 延迟关联三段式只救宽行排序,救不了 JOIN 计数随机回表。
三、语义与口径(不可妥协)
- 计费:fee≡上游真实拆分片数;
FeeSegments>0直接采信 > UCS2 按 SmsLengthUCS2 > GBK 默认; - MsgID = DetailID 雪花,全链统一(受理 Resp / 回执配对 / 跨重启一致);
- 长短信:完整性优先,72h 不齐 = 失败终态(LSM:NOTCMPL / 零费 / UNDELIV);组 ID=首片雪花;持久化-还原键字段必须成对审计(Day71 ref 字段教训);
- UNKNOWN:出向回执 72h 窗后保持 UNKNOWN(部分段事实送达,不标失败);
- 幂等三锚:task_no uk / detail pk / OnConflict DoNothing——重复扫描/重投/并发至多一次生效。
四、门禁纪律
- 七件套:go vet+test(-race 必须全量,aggregator 教训)→ lint → 前端四件 → 人工验收单归档 → 本人走查 → CHANGELOG → 日历/进度回填;
- 救火日七件套不豁免(Day59-65 破窗教训);救火缓冲 5+1;
- 部署串行:build→kill→确认退出→nohup→
md5sum /proc/PID/exe比对(并行 build+kill=旧 inode 幽灵进程)。
五、SSD 环境基线
buffer_pool 16~24G(按 64G 内存)/ innodb_io_capacity=2000, io_capacity_max=10000 / redo≥1G / Kafka flush 放宽靠副本兜底;workers:4 与消费顶 55/s 是 HDD 数字,S5 必须重标定;正式基线前置 24h 稳定性门槛(dmesg 零新增 + 进程零重启)。
六、CPU 缺陷基线 Plan B(决策树)
S0 开荒实测(stress-ng avx2/memcpy/vm + 20 轮编译循环):
- 复现率 = 0 → 正常推进;
- 0 < 复现 < 1 次/天 → 开发容忍(「偶发 SEGV 先查 dmesg 再重试」入 runbook);压测基线外置(借健康机器)或带脚注;
- ≥ 1 次/天 → 基线必须外置;建议机房换整机(重建 30+ 工作日不值概率性地基)。
七、备份与安全
- cron 每日
git bundle create /data/backup/v2-$(date +%F).bundle --all+ rsync 拉回本地(单人纪律不可靠,自动化); - 凭证/密钥永不入库;公网机器仅密钥登录 + fail2ban + 最小端口面。