Date: 11/20/2026Category: Rust编程Tag: Rust, RushWind, Protobuf, API设计
本文回答一个问题:前端只改了一个昵称,后端凭什么保证其余几十个字段一个都不会被碰坏?「把某字段清空」和「没传这个字段」又怎么在同一个接口里区分?——拆解 update_mask 从契约字段到 SeaORM 赋值行的整条写面链路。
RushWind Admin 的更新接口是同一个形状:请求体带一个 id 和一个大对象 data。麻烦全在细节里——管理后台的字段动辄几十个,一个"只改昵称"的表单提交,其余字段是原样回传的旧值;只要服务端照单全收,任何一个并发窗口里的旧快照都能把别人刚写进去的值覆盖回去。所以这条写面链路要回答的不是"怎么更新",而是三个更细的动词:写(这个字段变了)、清(这个字段要置空)、不动(请求里根本没有它)。整提交语义只有前两个的混合体,区分不了"清空"和"没传"——这就是 update_mask 存在的理由。这批更新接口的集合,仓库文档称作写面(write face):face 是契约驱动架构的既有词汇——同一份 proto 契约朝不同协议投影出 REST 面、gRPC 面、服务面,写面就是其中承载全部更新写路径的那一张,与查询侧相对。
