喵个咪的博客喵个咪的博客
TX7DO
文章列表
文章分类
文章标签
时间线
TX7DO
文章列表
文章分类
文章标签
时间线
健康养生 1fastapi 1随笔日志 1产品设计 1AI 6软件工程 2工程文化 1GoWind 110架构设计 3Go-Kratos 107Golang 153架构 1ASIO 2cron 1rclone 1flutter 1RxDart 1Make 2CMake 2Ninja 1设计模式 3Cache Aside Pattern 1缓存设计模式 1汽车 1go 2CDC 1PostgreSQL 6Centos 1docker 1杀毒 1CLion 1云手机 1GoogleTest 1Cococs2dx 1Cocos Creator 1代码注释 1IDE 3Python 4TRC20 1C++ 8类型转换 1CQRS 1Kafka Streams 1Bazel 2Docker 21Go 7crontab 1客户留存率 1EFK 1RustDesk 1Jitsi Meet 1Traefik 1Swagger 1Docker Hub 1VIM 1Word 1VBA 1Doris 2量化交易 2Flutter 19Widget 1Ent 4SQL 2Excel 2配色 1TypeScript 3C# 1Sealed Class 2微信小程序 1人脸识别 2RK3588S 1Android Studio 1iOS 1GetX 1鸿蒙 1字体渲染 1期货 1Futures 1地理围栏 1GEO 1Git 2AI Agent 2pgvector 1RAG 1BI 2大屏 1数据可视化 1通知系统 1打印 1前端组件 2chromedp 1工作流引擎 2Vue3 6React 7Protobuf 9Dart 1CMS 9设计系统 1响应式 1审批流 2内容治理 1React.js 1LLM 1数据安全 1Vue 6Nuxt 1OpenSearch 1搜索 1分布式任务 1Taro 1CRDT 1协同编辑 1ERP 2数据一致性 2BPMN 1IAM 1JWT 1Casbin 1OPA 1ent 1数据库 1IM 11音视频 1CRM 1消息系统 1OA 2协作文档 1知识库 1研发效能 1DevOps 1开放平台 1私有化部署 4选型 2实时协作 1算法 6记账 1工作流 1MQTT 3运维平台 2分布式 1Shop 4电商 1订单系统 1短视频 2多租户 2移动端 1推荐系统 1GoWind Toolkit 2代码生成 3Element Plus 1Ant Design 1UBA 5大数据分析 4ClickHouse 1OLAP 2数据架构 1Rust 6微服务 1WebRTC 3Security 3SaaS 1MongoDB 1Kratos 2CRUD 1GORM 1Wire 1Headless CMS 1WASM 1随机种子 1MacOS 3Ubuntu 2GCC 1Godot 1Clang 1Superset 1CentOS 1OpenCV 1咖啡 1Android 1Google Play 1Unity WebGL 1Dexie 1IndexedDB 1htop 1Postgresql 1Mattermost 1Qt 4TL;DR 1Swift 1Javascript 2JetBrains 1Typescript 1libuv 1Linux 1本地化 1国际化 1状态同步 1帧同步 1泡泡水 1Markdown 1机器学习 1QTT 1MSB 1LSB 1MySQL 1npm 1pnpm 1yarn 1OCR 1OHLC 1OLTP 1OpenAI 1OpenAPI 1数织 1Ping 1人体姿态识别 1全文搜索 1交叉表 1Prometheus 1Docx 1QUIC 1Reactor 1Websocket 1KCP 1Kratos-Transport 1Redis 1REST 1CoTURN 2RushWind 5契约测试 1中后台 1开源项目 1数据权限 1API设计 1gRPC 1RBAC 1SDD 1Selenium 1基准测试 1Spine 1股票 1Roguelike 2ThingsBoard 3时间戳 1时序数据库 3交易所 1Unity 2用户画像 1PgBouncer 1Vite 1WebGL 1加权随机 1数据血缘 1Roguelite 1Protocol 1WiFi 1WSL 3Windows 4
RushWind Admin — update_mask 写面:字段级白名单、显式清除与点路径合并

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 面、服务面,写面就是其中承载全部更新写路径的那一张,与查询侧相对。