逻辑先行:程序员忽略的三大编码铁律
|
接口超时告警那一刻,我正蹲在茶水间扒拉咖啡机——它卡在第三杯,滴答滴答漏着半温不热的褐水,跟去年八月那个下午一模一样。 监控大盘上那条绿色的线一直在抖,抖得我手抖。不是性能抖,是心跳抖。运维老张冲进来拍我肩膀,嘴里嚼着没咽完的煎饼,芝麻粒沾在下嘴唇上:“你那个/order/status查缓存没?我刚切流,全量打到主库了。”我没吭声,他转身就走,后颈上还贴着张没撕净的体温计贴纸。 逻辑先行。不是口号,是尸体堆出来的——去年八月那次雪崩,根因在改了个status字段,默认值从0改成null,但三个服务、两套定时任务、一个灰度开关,全他妈默认“非空即有效”。没人问一句:如果这个字段丢了,业务到底要它代表“未开始”,还是“不可用”,还是“我不care”。结果就是——订单状态链断在中间,下游以为已发货,物流发了空单,用户等三天收到个空盒。复盘会上产品举着平板说“这需求我们Q3就要上线”,前端小陈直接把椅子转过去,对着隔断板上卷了边的便签发呆,那张写着“2022.11.3 改字段别动status”字迹都晕开了。 我原以为只要加个not null约束+建个联合索引,问题就死了。结果呢?DBA在群里甩截图,show create table里那个字段还是TEXT类型,底下备注写着“兼容旧版APP”。我盯着看了两分钟,突然发现表结构脚本里混着一行注释:“// 此处临时跳过校验,等二期统一重构”——写的人叫李伟,三年前离职的。谁也没删这行注释,谁也没执行那句ALTER。 外卖筷子掉在地上,我捡起来擦了擦继续吃。第一铁律:字段语义必须早于类型定义。不是先想“我要用VARCHAR(64)”,是先钉死“这个字段只允许出现‘paid’‘refunded’‘cancelled’三种字符串,且不允许为空、不允许前后空格、不允许大小写混用”。可你看现在代码里,status的判断散在Controller、Service、甚至两个不同包下的DTO里,有的判==null,有的判.isEmpty(),有的判.equals("0")……而最绝的是那个老支付回调监听器,它把status当Integer解析失败后,居然fallback成String.valueOf(-1),于是日志里满屏都是"-1"——它根本不知道这是什么状态,它只是不想抛异常。 第二铁律:幂等标识必须早于接口暴露。不是先做接口,再补个traceId;是接口设计第一行就写明“此接口仅凭biz_no + action_type 做幂等键”。我们那个refund接口,上线三周后才加限流,五天后又加防重提交——但biz_no生成逻辑在前端,Android和iOS用两种MD5拼法,iOS还带了个timeZone偏移。上线当天,同一笔退款进库六次。我翻日志翻到凌晨两点,工位上电话响,隔壁组阿哲在跟房东谈房租,声音忽大忽小:“……押金扣一半?那您把洗衣机搬走!” 第三铁律:数据流向必须早于代码分支。不是merge之前才看CI跑不跑得通,是写第一行if之前,得画出这张数据从哪儿来、经谁手、到哪儿去、卡在哪、脏在哪、丢在哪。那个同步用户标签的定时任务,每天凌晨三点跑,但它的上游是风控实时流,延迟波动在2秒到47秒之间——可它的SQL没写任何延迟容忍,只管SELECT FROM user_tag WHERE updated_at > ?,参数是“当前时间减五分钟”。所以每天都有几百条新标签永远落不进去,直到某天DBA清日志,顺手删了三天前的binlog,连回滚都做不到。 机箱嗡嗡响,像台老拖拉机在抽风。我其实记不清是哪次慢查询把Redis压垮的了,大概那个量级吧——但肯定不是缓存击穿,是key没设过期,value是JSON数组越攒越大,最后GET一次要200ms。可问题是,谁定义过这个key该不该过期?没人。大家只说“缓存嘛,快就行”,没人问“快给谁看?看多久算有效?” 说到这儿我想起个事儿:上个月财务对账差三毛,追查三天,定位到某个优惠券发放记录里,amount字段被前端传进来的float截断过,后端接的是BigDecimal.valueOf(double),结果0.1+0.2=0.30000000000000004,存进去变成0.30000000000000004元。而财务系统读的时候,用的是MySQL的DECIMAL(10,2),自动四舍五入成0.30——看起来没毛病。但下游分账流水里,每笔多出0.00000000000000004元,积少成多,成了三毛。没人敢动那个字段的精度,因为另一个祖传报表导出服务,会把amount直接toString()然后写Excel,一改就崩。 所以它站得住,不是靠PPT,是靠优胜劣汰。活得久的系统,没一个是靠“先写了再说”的。是那些改字段前先写三页语义定义文档的、是写接口前先画数据血缘图的、是定幂等键前先拉着前端对三遍biz_no生成逻辑的——它们活下来了。剩下的,要么回滚了,要么半夜被call起来手动修复脏数据,要么干脆,被新系统替掉了。
文章配图,仅供参考 我今天下午打算把那个/status的枚举类抽出来,单独建个module,加checkstyle强制所有地方import这个enum,不许写字符串字面量。至于老李留下的那行注释……我先不动。等哪天阿哲跟房东谈妥了房租,心情好点,我请他喝杯好的,让他帮我review下迁移脚本。他以前干过DBA。 咖啡机还在漏,绿线还在抖,工位隔断上那张便签卷得更厉害了,露出底下一层胶痕。 (编辑:站长网) 【声明】本站内容均来自网络,其相关言论仅代表作者个人观点,不代表本站立场。若无意侵犯到您的权利,请及时与联系站长删除相关内容! |


程序员必追!本周技术动态速递


