https://xiongneng.me/tags/api%E7%89%88%E6%9C%AC/飞污熊小站Hugo 0.166.0 & FixIt v0.4.6-20260512073637-464c4659zh-CNyidao620@163.com (XiongNeng)yidao620@163.com (XiongNeng)XiongNengFri, 25 Sep 2026 02:16:47 +0000https://xiongneng.me/posts/java/springboot/sb4-apiversion/Mon, 21 Sep 2026 10:00:00 +0800yidao620@163.com (XiongNeng)https://xiongneng.me/posts/java/springboot/sb4-apiversion/Java<p>先讲一段我自己的亲身经历。订单服务跑到第二年，产品要在新版 App 里把金额拆开摆：商品金额、折扣、运费各自一行。我把 <code>/api/orders/{id}</code> 的响应体重构了一遍，customerName 与 customerPhone 聚成 customer 对象，金额拆成 items 数组加 amount 子结构，自测没问题就发了版。上线十分钟，财务的对账系统报警：它按字段平铺解析订单 JSON，customer 对象它不认识，整批对账任务全挂。回滚、发版、写死一套字段映射兼容代码，前前后后折腾了我一周。</p>