用途：dual-write 用于在新旧数据存储之间安全迁移，核心思路是在每次写操作时同时写入旧系统与新系统，从而支持渐进切换并保留回滚安全。适合数据库或 Schema 迁移、存储后端切换（如 SQL 到 NoSQL）、规划零停机迁移、审查写入多个数据存储的代码。若只需比较读响应、不必持久化数据，则应改用 shadow-mode（影子模式）。
迁移阶段：依次为准备（只读只写旧库）、双写（读写旧库，异步或同步写新库）、回填（将历史数据从旧库复制到新库直至一致）、影子读取（同时读取并比较）、切换（新库成为主库，可选继续写旧库）、清理。
写入策略：同步双写一致性强但延迟约为两倍写入，任一存储失败即失败；异步次要写入最终一致、延迟影响小，但次要存储可能滞后；另有 Outbox 模式（需消息代理）与变更数据捕获（需 CDC 基础设施）。
关键组件：写适配器负责把写入路由到两个存储并处理失败；读比较器读取两库、记录差异并返回主库结果；回填任务复制历史数据；对账检测并修复漂移；功能开关按实体或租户控制当前阶段。
用法要点：写适配器先写主（旧）库，再写次（新）库；次库失败时记录、入队重试，但不使请求失败，返回主库结果。影子读取阶段以主库为权威响应，异步读取次库并逐字段比较，记录差异与匹配率指标。回填需先对旧库做快照、再开始新写入的双写，按批次复制历史记录，并让双写优先于回填以避免冲突。
失败处理：次库写失败则记录并异步重试；主库写失败则请求失败且不写次库；两库皆失败则请求失败；次库超时则记录并异步校验修复；检测到不一致则记录完整上下文并人工或自动对账。
限制与前提：切换前主库始终是事实来源；异步双写时次库可能滞后；需依赖对账任务检测并修复漂移；仅当匹配率达到阈值（如 99.9%）才宜切换。切换决策可参考读比较匹配率、回填完成度、次库写入成功率、P99 延迟增幅、对账未解决差异等指标。
常见陷阱：两库间顺序问题、事务边界不同、Schema 不匹配、回填与实时写入冲突、性能下降、部分失败导致不一致、遗漏某些代码路径未双写。缓解方式包括幂等写入并携带版本或时间戳、显式字段映射、让实时双写优先于回填、先用异步次写、以对账任务兜底、将写入集中到写适配器并审计调用点。
回滚：双写阶段可停止写新库且不丢数据；影子读取阶段可停止比较；切换读可切回旧库；切换写需反转写顺序，可能需要对账；清理阶段旧库已退役，无法回滚。
监控检查项包括各库写入成功率、写入延迟分位、读比较匹配率、回填进度、对账队列深度、按失败类型的错误率以及按租户或实体的功能开关状态。
说明：资料未提供具体安装命令、代码示例、定价或平台支持信息，暂未提供。