Confluence 空间迁移完成后出现页面树错位、权限继承异常和附件归属混乱，通常指向同一类问题：源端的层级关系、权限模型和附件版本绑定，在目标端没有被完整映射或重新计算。处置时先冻结目标端写入并保留源端快照，再按“页面树—权限—附件”的顺序分批修复，每批小范围验证后再扩大，避免在原因未确认时全量重跑迁移。若迁往 ONES Wiki，可结合其空间、页面、附件和权限结构的迁移能力安排核对。
要点总览（TL;DR）
- 三类异常通常来自迁移映射与继承规则不一致：页面树错位多因父页面缺失、排序字段丢失或跨空间链接未重写；权限异常多因源端权限模型与目标端继承机制不同；附件混乱多因版本绑定丢失或同名覆盖。
- 处置前先冻结目标端写入并保留源端与目标端快照，再按“页面树—权限—附件”的顺序分批修复，每批小范围验证后再扩大。
- 权限问题优先处理，因为受限内容一旦扩大暴露，事后收回权限也无法消除影响；页面树次之，附件整理可最后推进。
- 修复完成后按层级、权限角色、附件版本三个维度抽样比对源端与目标端，并把异常分类表、原因假设对照表和校验清单固化为下次迁移的检查项。
- 迁往 ONES Wiki 时，其 Confluence 迁移方案覆盖空间、页面、附件和权限结构，修复阶段可按空间逐批核对层级、权限范围和附件归属。
先确认异常范围与影响面
迁移后的异常往往混在一起出现，先分类登记比直接动手修更重要。把问题按页面树、权限、附件三类分别记录表现、涉及空间、影响用户和首次发现时间，才能判断是局部映射失败还是整批迁移遗漏。分类时以“用户实际看到什么”为准，不以迁移日志里的成功条数为准。
三类异常的典型表现
- 页面树错位：子页面出现在空间根目录或错误父页面下，层级断裂；部分父页面缺失，导致整段子树悬空；同级页面排序与源端不一致；跨空间引用的页面链接指向空页面或旧地址。
- 权限继承异常：子页面可见范围超出预期，原本受限的内容被更多用户看到；继承链在某一层断裂，下级页面不再跟随父页面权限；个别页面权限被重置为默认值，原有协作者失去编辑权。
- 附件归属混乱：附件挂到了错误页面，或集中落在空间级附件列表中；附件版本与页面版本错配，最新版内容对应旧页面；同名文件互相覆盖，只剩一份；原下载链接失效或跳转到其他文件。
按影响面排序处置优先级
优先级依据“暴露范围”和“可逆程度”判断，而非问题数量。对外可见的权限问题排第一，因为受限内容一旦被无关人员看到，事后收回权限也无法消除已经发生的暴露；页面树错位排第二，它影响导航和查找，但内容本身仍在；附件整理排第三，多数情况可以通过清单逐项核对恢复。若某类异常涉及对外共享空间或客户可见页面，应单独标记并立即处理。
| 异常类型 | 优先处理条件 | 可暂缓条件 |
|---|---|---|
| 权限继承异常 | 涉及对外共享、客户可见或敏感内容空间 | 仅影响内部少数协作者的编辑权限 |
| 页面树错位 | 核心知识库入口页面缺失、导航不可用 | 边缘空间层级混乱但不影响查找 |
| 附件归属混乱 | 合同、设计稿等关键附件无法下载或版本错误 | 历史归档空间的附件待整理 |
原因假设与排除证据
三类异常各自对应若干可能原因，排查时把假设和证据分开记录：先写下假设，再找能证实或排除它的材料，确认后再进入修复。迁移日志、页面导出清单、权限对照表和附件清单是主要证据来源，单凭目测页面状态容易误判。
页面树错位的假设与验证
- 父页面未迁移：核对导出清单中父页面是否在迁移范围内，以及日志中该页面是成功、跳过还是失败。若父页面缺失，子页面通常被挂到空间根目录。
- 排序字段未导出：对比源端同级页面顺序与目标端顺序，检查导出文件是否包含排序或位置字段。排序丢失通常表现为同级页面按创建时间或标题排列。
- 跨空间链接未重写：抽查引用其他空间的页面链接，确认目标端是否已建立对应页面及新地址。链接未重写时，页面树本身可能完整，但引用关系断裂。
权限继承异常的假设与验证
- 权限模型差异：源端可能以空间权限为主、页面级限制为辅，目标端继承机制不同。用权限对照表逐层比对源端与目标端的可见范围，找出第一处不一致的层级。
- 迁移账号权限不足：检查执行迁移的账号是否具备读取源端受限页面和写入目标端权限设置的权限。权限不足时，相关页面常以默认权限落库。
- 继承开关未开启或被打断：查看目标端页面是否处于继承父级权限的状态。继承链断裂的页面往往有独立权限记录，可与源端该页面的限制记录对照。
附件归属混乱的假设与验证
- 版本绑定丢失：对比附件清单中的版本号与页面版本历史，确认附件是否只迁移了最新版或版本顺序错乱。
- 同名文件冲突：统计同一页面或同一空间内同名附件数量，检查目标端是否只保留一份、其余被覆盖。
- 大小或类型限制导致跳过：在迁移日志中检索跳过、失败或超限记录，与源端附件清单做差集，确认缺失附件的具体原因。
| 异常类型 | 原因假设 | 验证证据 | 确认后的含义 |
|---|---|---|---|
| 页面树错位 | 父页面未迁移 | 导出清单与迁移日志的页面差集 | 需补齐父页面后重建子树 |
| 页面树错位 | 排序字段未导出 | 同级页面顺序对比 | 需按源端顺序手工修正 |
| 权限继承异常 | 权限模型差异 | 权限对照表逐层比对 | 需按目标端继承规则重算 |
| 权限继承异常 | 迁移账号权限不足 | 迁移账号权限记录与日志告警 | 需补权限后重迁受影响页面 |
| 附件归属混乱 | 版本绑定丢失 | 附件清单与页面版本历史对照 | 需按版本重新绑定 |
| 附件归属混乱 | 同名文件覆盖 | 同名附件统计与日志 | 需从源端补回被覆盖文件 |
按异常类型分批处置的步骤
处置前先做两件事：冻结目标端写入，通知协作者暂停编辑；同时保留源端完整快照和目标端当前状态快照。冻结的目的是防止修复过程中新旧数据交叉，快照是回退依据。修复按页面树、权限、附件的顺序推进，因为页面树稳定后权限才能按层级重算，附件也需要正确的页面归属作为挂载点。
第一步：修复页面树
- 以导出清单为基准，列出缺失的父页面，优先从源端补迁或手工创建占位页面。
- 按源端层级逐层重建父子关系，先处理顶层空间首页，再向下展开，避免边修边产生新的悬空页面。
- 修正同级页面排序，按源端顺序调整位置字段。
- 逐条检查跨空间引用链接，替换为目标端对应页面的新地址，确认跳转可达。
每完成一个空间或一个一级子树，抽查若干页面确认层级正确，再处理下一个。若发现父页面在源端本身已被删除或归档，应在清单中标注，不强行重建。
第二步：重算权限继承
- 按“空间—一级页面—子页面”的顺序逐层核对可见范围，以权限对照表为准。
- 对继承链断裂的页面，恢复其继承父级权限的状态，再单独处理确有独立权限需求的页面。
- 对权限被重置的页面，按源端记录恢复协作者和角色，避免直接批量放开空间权限。
- 涉及对外共享的空间单独复核，确认外部访问入口和可见内容范围。
权限修复的风险高于页面树，因为放开容易收回难。每调整一层，用受限账号实际访问验证一次，确认看不到不应看到的内容，再进入下一层。
第三步：重新绑定附件
- 按附件清单逐项核对附件与页面的对应关系，把挂错位置的附件移回正确页面。
- 对版本错配的附件，按源端版本历史重新上传或调整版本顺序，确保最新版对应最新页面内容。
- 处理同名冲突：从源端取回被覆盖文件，采用“页面名—附件名—版本”的命名区分，避免再次覆盖。
- 抽查下载链接，确认附件可正常下载且内容与源端一致。
停止点与回退条件
出现以下情况应停止当前批次并回退到快照：权限调整后发现受限内容已对超出范围的人员可见且无法确认暴露边界；页面树重建过程中出现大面积父子关系反复错乱，说明映射规则本身有问题；附件补迁持续失败或覆盖了目标端已有文件。回退后先补充证据、修正迁移映射，再重新安排批次，不在同一状态下反复重试。
若迁移目标是 ONES Wiki，其 Confluence 迁移方案覆盖空间、页面、附件和权限结构，并支持迁移用户、用户组、空间权限与页面权限，以及页面正文、附件、图片、常用宏和批注。修复阶段可按上述顺序，在目标端逐空间核对页面层级、权限范围和附件归属；具体到页面树排序和附件版本冲突的处理规则，实施前宜与迁移实施方确认操作口径。
恢复验证与复发预防
修复完成不等于恢复完成，需要用抽样比对证明三类异常都已收敛。验证以源端为基准，按层级、权限角色、附件版本三个维度分别抽样，抽样应覆盖核心空间、受限空间和历史归档空间，不能只查迁移日志显示成功的部分。
抽样校验方法
- 按层级抽样：每个一级子树抽取顶层、中间层和叶子页面各若干，核对父页面、同级顺序和跨空间链接。
- 按权限角色抽样：分别用空间管理员、普通成员、受限成员和外部协作者账号访问同一批页面，比对可见与可编辑范围是否与源端一致。
- 按附件版本抽样：抽取有多次版本的附件，核对版本数量、最新版内容和下载链接；抽取同名附件，确认未被覆盖。
验收标准
| 维度 | 验收标准 | 不通过时的处理 |
|---|---|---|
| 页面树 | 抽样页面父子关系与源端一致，核心空间无悬空页面，跨空间链接可达 | 回到页面树修复步骤，补齐缺失父页面 |
| 权限 | 各角色可见范围与源端对照表一致，受限内容未扩大暴露 | 暂停该空间对外访问，逐层复核继承状态 |
| 附件 | 抽样附件可下载，版本数量与内容正确，同名文件均已区分 | 从源端补回缺失版本，重新绑定页面 |
复发预防措施
下次迁移前，先在源端整理父页面完整性，清理无父级的孤立页面，确认排序字段可导出；统一权限模型，减少页面级独立权限的数量，让继承关系更简单；制定附件命名与版本规范，对同名文件提前改名；迁移全程保留日志和导出清单，作为异常排查和验收的依据。把本次使用的异常分类表、原因假设对照表和抽样校验清单整理成迁移检查项，在正式迁移前逐项确认，迁移后按同一清单验收。
对于采用 ONES 迁移方案的团队，可把上述检查项与迁移实施的分阶段安排结合：正式迁移前确认数据范围、功能匹配和系统适配，迁移后按空间逐批核对页面层级、权限范围和附件归属，把校验结果记录在案，作为业务切换前的确认依据。
常见问题
迁移后页面树错位，应该先补父页面还是先调整排序？
先补父页面。父页面缺失时，子页面通常被挂到空间根目录或错误位置，此时调整排序没有意义，因为层级关系本身还没建立。建议以导出清单为基准，先列出缺失的父页面并从源端补迁或创建占位页面，再按“空间首页—一级页面—子页面”的顺序逐层重建父子关系，最后修正同级排序和跨空间链接。每完成一个一级子树就抽查一次，确认层级正确后再处理下一个。
权限继承异常修复时，为什么不能直接批量放开空间权限？
批量放开空间权限会让原本受限的页面一并对外可见，而权限放开容易、收回难，已经发生的暴露无法通过事后调整消除。更稳妥的做法是按“空间—一级页面—子页面”逐层核对可见范围，对继承链断裂的页面恢复继承父级权限的状态，对确有独立权限需求的页面单独设置。每调整一层，用受限账号实际访问验证一次，确认看不到不应看到的内容，再进入下一层。涉及对外共享的空间应单独复核外部访问入口。
附件同名覆盖后，从源端补回文件需要注意什么？
补回前先确认目标端被覆盖的是哪个版本，避免用旧版覆盖新版。补回时采用“页面名—附件名—版本”的命名区分同名文件，再按源端版本历史重新绑定到正确页面，确保最新版对应最新页面内容。补回后抽查下载链接，确认文件可下载且内容与源端一致。若同名附件数量较多，建议在下次迁移前先在源端完成改名，减少迁移时的冲突面。
修复过程中出现反复错乱，什么情况下应该停止并回退？
出现三类情况应停止当前批次并回退到快照：权限调整后发现受限内容已对超出范围的人员可见，且无法确认暴露边界；页面树重建时出现大面积父子关系反复错乱，说明迁移映射规则本身有问题；附件补迁持续失败或覆盖了目标端已有文件。回退后先补充证据、修正映射规则，再重新安排批次，不在同一状态下反复重试。
迁往 ONES Wiki 时，迁移方案能覆盖哪些数据，修复阶段还要注意什么？
ONES 的 Confluence 迁移方案覆盖空间、页面、附件和权限结构，数据范围包括用户、用户组、空间权限与页面权限，并支持迁移页面正文、附件、图片、常用宏及批注。修复阶段可按“页面树—权限—附件”的顺序，在目标端逐空间核对页面层级、权限范围和附件归属。页面树排序和附件版本冲突的具体处理规则，建议在实施前与迁移实施方确认操作口径，并把核对结果记录在案，作为业务切换前的确认依据。
