WireGuard数据迁移不是复制文件，是在数据持续产生时换系统——本文给出分佣账本迁移前的4类基准线核验清单、并行期对账周期设计，以及3类迁移失败应急处理方案。
决定放弃WireGuard自建之后，大多数团队第一个动作是找新方案。
第二个动作，才想起来问：那些代理层级、历史分佣记录，怎么搬过去？
这个顺序本身就是问题的开始。选型是一次性决策，可以慢慢比对。数据迁移不是——它发生在系统仍在运行、数据仍在产生的窗口里。
先看这组数： 迁移前需核验4类基准数据（层级结构/结算记录/待处理分佣/异常记录），并行期窗口有3天/7天/14天/30天四档选择，迁移失败常见3种类型各有对应应急处理方式。窗口不是越长越安全——本文会讲清楚为什么。
常见问题
Q1：迁移过程中代理还能正常提现吗？
并行期内建议保持原系统提现通道不中断，新系统同步验证后再切换主通道。
这不只是技术问题，也是信任问题——代理层级下的用户对系统稳定性的敏感度很高，提现通道中断即便只是短暂的，也容易引发不必要的猜测。保持原通道畅通，是迁移期沟通成本最低的做法。
Q2：历史分佣记录要保留多久？
建议至少保留完整的一个结算周期，加上审计所需时长。具体保留期限因地区法规差异较大，需以当地合规要求为准，不建议自行设定一个固定天数后一刀切清理。
Q3：迁移失败了能不能退回原系统？
能，但前提是原系统在并行期内保持只读可用。这也是为什么不建议迁移当天就关停原系统——一旦关停，退回路径就没了，出问题只能硬扛。迁移验收没通过之前，原系统的只读状态就是你的安全绳。
为什么迁移比选型更容易出问题
选型时算清楚的成本，迁移时反而容易出问题。为什么？
因为选型是一次性决策，你可以慢慢比、反复算，改主意的成本很低。迁移不是——它是一个持续过程，发生在数据仍在产生的窗口里。
分佣系统的数据不是静态的。新增下注每天在跑，结算每天在跑，分佣计算每天在跑。你不是在"复制一份文件"，你是在数据持续变动的情况下，切换承载这些数据的系统。
这就带出了迁移的核心矛盾：迁移窗口越长，新旧系统的数据差异会越大；窗口越短，核验就越不充分。两边都有代价，没有一个自动正确的答案。
选型阶段的失误，往往在决策之前就能被反复验证纠正。迁移阶段的失误，很多时候是数据已经产生了才发现——层级映射错了，一批分佣记录已经按错误比例结算出去了。这就是为什么迁移需要的不是"聪明的方案"，而是"扎实的核验流程"。
迁移前基准线核验清单：4类数据
机理讲清楚了，现在给清单。
迁移前必须核验的基准数据，分四类。如果你的历史数据分散在多个节点（比如原系统本身就是多个实例拼起来的），应当优先核验代理层级结构——这是最容易出现映射错误、且错误后果最严重的一类。
第一类，代理层级结构
谁在谁下面，分佣比例是多少。这是整个迁移最基础也最容易出错的部分。层级关系一旦映射错误，后续所有的分佣计算都会跟着错。
核验方法：导出原系统的完整层级树，逐层核对每一级的上下级关系和分佣比例设置，与业务侧（了解真实代理关系的运营或财务人员）交叉确认，不能只依赖系统数据单方面导出。
第二类，历史结算记录
已经完成结算的记录，和还在结算流程中的记录，边界在哪里。这个边界如果模糊，会导致同一笔分佣被重复计算，或者遗漏。
核验方法：明确一个"结算截止时间点"，这个时间点之前完成的记录标记为已结算，之后的记录进入待处理分佣核验流程。
第三类，待处理分佣
迁移当天，有没有"卡在中间"的分佣记录——已经产生下注、但分佣计算还没跑完的这批数据。这批数据是迁移过程中最容易被漏掉的一类，因为它既不在"已结算"里，也不在"新系统的起点"里。
核验方法：迁移窗口开始前，先跑完一轮完整的分佣计算，把待处理分佣清空到最少，再开始迁移动作。
第四类，异常/坏账记录
账单层缺失导致的坏账问题，是迁移前必须先处理的，不能带着坏账迁移到新系统。带着未处理的异常记录进入新系统，等于把旧问题原样搬到新环境里，新系统的账本从第一天就是不干净的。
核验方法：迁移前先跑一轮异常记录扫描，把坏账和异常单独隔离出来，在旧系统里处理完，或者明确标记为"不迁移、单独归档"，不能含糊带过。
迁移前基准线核验清单 ┌─────────────────┬──────────────────────┬───────────────┐ │ 数据类型 │ 核验方法 │ 核验负责人角色 │ ├─────────────────┼──────────────────────┼───────────────┤ │ 代理层级结构 │ 导出层级树+业务侧交叉确认│ 运营+财务 │ │ 历史结算记录 │ 明确结算截止时间点 │ 财务 │ │ 待处理分佣 │ 迁移前跑完一轮完整计算 │ 技术+财务 │ │ 异常/坏账记录 │ 迁移前扫描+隔离处理 │ 财务+技术 │ └─────────────────┴──────────────────────┴───────────────┘
⚠️ 核验清单为通用框架，具体节点视自身系统架构调整。不同历史数据分散程度对应的核验重点不同，需结合自身情况判断优先级。基准线核验不是一次性动作，迁移过程中需持续复核。核验投入的人力和时间成本因数据规模差异较大，需提前评估资源投入。
「迁移不是搬家，是在数据持续产生的情况下换水管。」
并行期不是越长越安全
大多数团队的直觉是：并行期越长，越保险。多跑几天，多核对几遍，总不会错。
数据说的是另一件事。
并行期越长，两套账本的差异不是线性累积的，而是随着时间推移加速累积——新增数据在两个系统里各走各的路径，时间越长，需要人工核对的分歧点越多，核验的复杂度会明显加速上升，不是简单的"时间乘以工作量"。
见过团队并行跑了三个月，结果两套账本对不上的地方越来越多，最后干脆推翻重新核验一次——比一开始定7天窗口反而更麻烦。拖着不切换，不是稳妥，是把问题往后堆。
| 并行期窗口 | 核验工作量 | 适用场景 |
|---|---|---|
| 3天 | 低 | 数据量小、层级结构简单、团队核验资源充足 |
| 7天 | 中 | 常规规模团队、层级结构中等复杂度 |
| 14天 | 需重点关注 | 数据量较大或历史遗留问题较多，需要更充分核验周期 |
| 30天 | 易失控 | 通常不建议，差异累积风险显著上升，核验难度大幅增加 |
⚠️ 本表为通用参考框架，具体窗口选择需结合自身数据规模和团队核验能力判断，不构成唯一标准。工作量对比为定性描述，实际情况因系统架构差异较大。
「并行期是核验，不是保险——核验完就该切。」
窗口选多长，不取决于"越长越安心"的直觉，取决于你的核验团队能在多长时间内把该核对的都核对完。核对完了就切，别恋战。
3类迁移失败的应急处理
框架和清单都有了，说说万一出问题怎么办。
类型1：层级结构还原错误
代理层级关系对不上，分佣比例算错了。这类错误通常在迁移后的第一轮结算周期内暴露——数字和预期不一致。
应急处理：立即回退到原系统只读状态，暂停新系统的分佣计算，重新核验层级映射表。不要在新系统里"边跑边改"，那样容易越改越乱，先回到干净的起点重新核对。
类型2：并行期数据差异超出预期
两套账本的差异越滚越大，超出了核验团队能覆盖的范围。
应急处理：缩短并行期，提高核验频率，而不是反过来延长并行期。差异已经在加速累积了，拖下去只会更难收敛。集中资源在短时间内核验完，尽快切换，比拖着两套系统一起跑更有效。
类型3：坏账/异常记录带入新系统
账单层缺失的坑就是从这里开始的问题如果迁移前没处理干净，这类遗留问题就会原样出现在新系统里。
应急处理：迁移前必须清理，不能"迁移完再处理"。如果已经迁移完才发现坏账记录带进来了，需要在新系统里单独隔离标记，不能让它混在正常账本里继续计算，同时回头核查是否有其他关联记录也需要同步隔离。
⚠️ 应急处理方式为通用建议，具体执行需结合自身系统架构判断。3类失败类型可能同时出现，需综合判断优先处理顺序。应急预案应在迁移前预先制定，而非出现问题后临时应对。回退或重新核验涉及额外人力时间投入，需在迁移预算中预留缓冲。
迁移验收的标准，本质上就是这3类问题都排查过一遍且没有遗留——不是"新系统跑起来了"就算完成，是"跑起来且账对得上"才算完成。
如果你不确定核验清单是不是齐全
基准线核验清单、并行期窗口设计、3类应急处理——框架给完了。
但很多团队卡住的地方，不是不知道要核验什么，而是"核验到什么程度算够"这个判断本身没底。数据规模、团队能力、历史遗留问题的复杂程度，每个团队都不一样，同一份清单在不同团队手里，核验的深度会完全不同。
如果你已经决定迁移，但不确定基准线核验清单是不是齐全——WG.com官网可以帮你过一遍迁移前的核验框架，不替你接管迁移执行。