Skip to content

状态所有权与单一数据源:让每个事实只有一个权威写入者 ​

所有者必须拥有该事实的写入命令、冲突决策和版本推进;其他位置只能保存可重建投影、有限期缓存或明确草稿。两个位置若都能独立接受写入并靠 Effect 对齐,就已经形成双主而不是单一数据源。

前置知识与能力边界 ​

本文处理前端状态归属、派生与同步;数据库主从和事件溯源不在本文范围。

1. 定义、所有权与数据流 ​

状态所有权说明谁可以权威修改一个事实;单一数据源要求同一事实不在多个可写位置独立维护。组件可以拥有缓存、投影和草稿,但必须能指出其来源、同步方向和冲突规则。

mermaid
flowchart LR
    A0["权威事实"] --> A1
    A1["受控命令"] --> A2
    A2["唯一写入者"] --> A3
    A3["派生快照"] --> A4
    A4["多个消费者"]

状态所有权定义唯一的权威写入者;单一数据源禁止同一事实在多个可写位置独立演进。缓存、草稿和投影可以存在,但必须标明来源、方向与冲突处理。

2. 关键机制 ​

2.1 权威性 ​

服务端记录、URL、表单草稿或组件交互各有不同权威源。

若边界缺失,把所有东西都称为全局真相。

验证:为每个字段标记 owner。

2.2 生命周期 ​

所有者至少活到最后一个消费者不再需要该事实。

若边界缺失,状态放得过低导致卸载丢失。

验证:导航和卸载测试。

2.3 写权限 ​

消费者通过命令请求变更,不直接改共享对象。

若边界缺失,任意写入破坏不变量。

验证:公开动作白名单。

2.4 派生值 ​

可由其他字段纯计算的值不另存。

若边界缺失,items 与 total 漂移。

验证:属性测试比较派生。

2.5 草稿与已提交 ​

草稿属于表单,已提交事实属于服务端。

若边界缺失,背景刷新覆盖编辑。

验证:dirty 时进入冲突策略。

2.6 缓存 ​

缓存有来源、时间和失效规则,不成为第二权威。

若边界缺失,修改缓存后假定服务端成功。

验证:mutation 对账。

2.7 受控边界 ​

父组件拥有 value,子组件只发 onChange。

若边界缺失,父子同时维护副本。

验证:Props 变化与事件序列测试。

2.8 身份 ​

稳定 id 连接多个投影,数组索引不承担身份。

若边界缺失,重排后选择错对象。

验证:插入删除重排测试。

2.9 同步 ​

必须定义单向源→投影,双向同步需要冲突协议。

若边界缺失,两个 Effect 互相回写。

验证:数据流图检查环。

2.10 重置 ​

登出、切租户和资源删除明确销毁所有投影。

若边界缺失,旧用户状态残留。

验证:边界端到端测试。

3. 建立状态清单与所有权表 ​

给每个状态记录权威源、写命令、生命周期、消费者、是否派生、是否持久化和冲突规则。filter 若由 URL 拥有,组件只解析 location;draft.name 由表单拥有,服务端背景快照不能直接 reset;isEmpty 可由 items.length 派生,不应另存。只有写出这张表,团队才能区分“共享”与“权威”。

4. 消除双写的迁移顺序 ​

  1. 记录两个副本的全部写入路径和读消费者。

  2. 选择能覆盖完整生命周期且有权执行不变量的一方作为 owner。

  3. 把另一方改为纯派生或只读缓存,停止反向 Effect。

  4. 将变更改成语义命令并迁移消费者。

  5. 用前进后退、背景刷新、乱序响应和重置测试证明没有回弹。

5. 应用案例一:筛选表格 ​

  1. URL 拥有 query/category/page,解析结果生成 query key。

  2. 表格本地只拥有 hover 和列宽,不初始化一份 filters。

  3. 修改筛选执行导航并重置 page,popstate 后重新解析。

  4. 查询缓存拥有结果快照,不复制到全局 store。

  5. 刷新、分享和前进后退得到相同控件与请求。

结果:刷新和返回恢复同一查询,不存在 filter useState 副本。

失败分支:若本地筛选与 URL 同时更新,快速后退会产生回弹。

6. 应用案例二:编辑资料 ​

  1. 服务端 Profile 是基线,表单 draft 是未提交意图。

  2. dirty=false 时背景新版本可替换基线;dirty=true 时进入 conflict。

  3. 提交携带 baseVersion,409 返回 latest。

  4. 用户选择覆盖、放弃或逐字段合并,不能由 Effect 自动决定。

  5. 成功响应同时成为新基线并清除 dirty。

结果:提交携带 version,409 后让用户比较。

失败分支:简单 useEffect(reset(serverData)) 会销毁未提交输入。

7. TypeScript 核心实现 ​

下面代码用显式命令维护一个权威状态,并从它计算只读投影。外部缓存和 DOM 只通过适配器报告事件,不能绕过所有者直接改写投影。

tsx
type ProfileState =
  | { kind: "clean"; server: Profile }
  | { kind: "editing"; baseVersion: number; draft: Profile }
  | { kind: "conflict"; baseVersion: number; draft: Profile; latest: Profile };
type Profile = { id: string; version: number; name: string };
export function receive(state: ProfileState, latest: Profile): ProfileState {
  return state.kind === "clean"
    ? { kind: "clean", server: latest }
    : { kind: "conflict", baseVersion: state.baseVersion, draft: state.draft, latest };
}

只读类型可以限制调用方式,却不能发现同一事实被复制到 URL、store 和组件后分别更新。应记录每次写入的所有者和版本,用竞态测试验证迟到事件不会覆盖新事实。

8. 方案选择 ​

方案适用条件成本与限制
局部拥有消费者同一子树且生命周期短跨页会丢失
提升到共同祖先少数兄弟需同步祖先可能重渲染
外部权威源跨树、跨页或远端事实需订阅和冲突规则

决定所有者时要问谁能权威确认、谁负责冲突以及事实活多久,而不是谁最方便调用 setState。缓存、草稿和投影可以并存,但必须是单向可重建或有明确合并协议。

9. 调试与失败注入 ​

现象检查修正
值来回跳是否两个可写副本选择 owner 并删除反向 Effect
总数不对是否保存派生值用 selector 计算
刷新覆盖草稿是否混淆基线与草稿版本冲突状态
重排选错行是否用 index 身份稳定 id
登出残留是否缺少 reset销毁用户命名空间
测试依赖顺序是否共享单例每例新建 owner
缓存假成功是否跳过 mutation服务端对账
返回键失效URL 是否只是初始化源持续从 location 派生

先为异常字段列出所有可写位置和写入时间线,再确认哪一个才是权威所有者,最后检查派生值是否被 Effect 反向同步。失败信号是两个 setter 修改同一事实、返回导航后状态分叉或缓存显示假成功;用写入日志、延迟响应和重放时间线验证。

10. 性能、安全与运维边界 ​

  • 为关键状态建立 ownership 表。
  • 服务端权威字段不得仅靠客户端限制。
  • 派生 selector 要纯且可测试。
  • 异步写入带版本或关联 ID。
  • 登出与租户切换销毁投影。
  • 日志区分草稿、缓存和已提交事实。
  • 避免 Effect 维持双向镜像。
  • 性能优化不能复制第二份可写状态。

生产验证至少记录一次正常路径和一次故障路径;对“状态所有权与单一数据源”的结论必须能关联到日志、Profile、网络记录或自动化测试。

11. 与其他架构模块集成 ​

  • URL 拥有导航事实。
  • Query cache 拥有远端快照。
  • Form 拥有未提交字段。
  • Interaction state 留在局部组件。

集成时为 URL、表单、查询缓存和领域实体分别标注权威范围,只跨边界传命令、版本和只读投影。需要冲突时显式进入冲突状态,不用双向 Effect 维持表面一致。

12. 综合练习 ​

为企业后台列出 20 个状态的所有者、生命周期、消费者、持久化和冲突策略,并消除至少三个双写。

验收标准 ​

  • [ ] 至少20个状态均标明 owner 与生命周期。
  • [ ] 删除三个可由事实派生的可写字段。
  • [ ] URL 与本地筛选不再双向 Effect 同步。
  • [ ] 背景刷新不覆盖 dirty 表单。
  • [ ] 登出与资源删除清理全部投影。

13. 派生值与缓存投影 ​

派生不等于每次都昂贵重算。可以用 memoized selector 缓存计算,但缓存没有独立写入口:输入引用不变时复用结果,输入变化时重新计算。总价、已选数量、是否为空和按钮 disabled 常属于派生值。

远端查询缓存不同于纯派生,它保存异步快照并有 stale 与失效规则,但权威写入者仍是服务端。乐观更新是有回滚和对账的预测,不会把缓存提升为数据库真相。

审查发现两个 state 名字相同还不够,要比较语义。例如 selectedOrderId 可以由 URL 拥有,而拖拽期间的 previewOrderId 属于局部交互;它们不是重复事实。相反,filters 与 searchParams 若能无损互转并互相回写,通常是同一事实的双写。

14. 所有权冲突审查实例 ​

一个订单后台同时出现以下字段:

字段权威所有者允许的投影冲突处理
status服务端订单记录Query cache、状态标签mutation 后按服务端 version 对账
statusFilterURL筛选控件值、query key非法值规范化后 replace
editNote当前表单离开确认、草稿白名单背景刷新不覆盖 dirty 值
activeRowId表格交互 Rootroving tabindex行删除时选择后继
canRefund服务端授权投影按钮可见性敏感操作再次由服务端授权

status 和 statusFilter 名字相近但不是同一事实;前者描述单个订单,后者描述集合查询。editNote 与订单 note 描述同一业务字段的不同时间版本,因此需要 baseVersion 和提交对账。

14.1 用删除测试识别派生字段 ​

尝试删除 isEmpty、selectedCount、canSubmit 的写入代码,改为从 items、selection 和 form validity 计算。如果功能与性能都满足,它们不应拥有独立 state。性能不足时添加 memoized selector,而不是恢复第二个写入口。

14.2 用时间线识别竞态 ​

记录 t0 加载 version 3、t1 用户编辑、t2 背景收到 version 4、t3 用户提交的完整时间线。每个节点写出谁能修改什么。若 t2 的 Effect 直接 reset 表单,它越过草稿所有者;正确模型在 t2 保存 latest 并进入 conflict。

14.3 用重置测试检查边界 ​

执行登出、租户切换、删除订单和浏览器后退。每个事件都应有明确的销毁清单。仅清空全局 store 而保留 Query cache 或 localStorage,仍会让下一主体看到旧投影。

15. 所有权评审问题 ​

评审一个新增 state 时要求提交者回答:哪个事件能修改它、删除组件后是否仍需要、能否由已有事实计算、刷新是否恢复、与服务端冲突谁获胜。答案必须落到具体对象,不能只写“放全局方便使用”。

若多个模块都要发写命令,仍可有单一所有者:命令入口集中验证并发布快照。单一数据源限制的是权威写入位置,不限制消费者数量,也不要求所有数据进入同一个 store。

来源 ​

从前端走向软件产品工程的长期路线图。