接口契约

«结论先行：联调返工里最阴的一类，不是字段名写错、也不是枚举漏值，而是「单位/量纲」没约定——同一个字段，前端理解成元、后端吐的是分；同一个时间戳，这边按毫秒、那边按秒。它比"字段缺失"更危险，因为每个环节都"看起来对"：接口 200、字段

背景 做了 3 年中间件研发，期间给 4 个团队搭过 API 网关、写过服务间调用 SDK。每次 onboarding 新同学，我都会问一句：「咱们的 OpenAPI spec 文件在哪？最近一次更新是什么时候？」 答案通常是： - 「在

背景 超时重试是分布式系统的标配，而幂等就是重试的解药。但"在哪一层做幂等"这件事，我在 5 年里至少换过三个团队，三个团队的姿势完全不同，每次迁移都要重写一遍。 常见分歧大致有四种做法： 做法 A：网关层统一兜底。 在 API Gatew

现象与背景：返工不是出在功能，而是出在"没写全" 我做过 3 年技术 PM，复盘过 14 个迭代的联调返工单，一个反直觉的结论：导致前后端联调返工的工单里，约 70%（9/14）根因不是"功能做错"，而是"PRD 没写全"。具体三类高频缺失