Confluence 空间迁移完成后发现页面树错位、附件挂到别的页面，通常与迁移映射和导入顺序有关：父页面尚未建立时子页面被挂到根节点或就近节点，标题重名让挂载产生歧义，附件按页面 ID 而非路径关联，跨空间引用未重写。本文按“分清症状—验证原因—处置修复—验证预防”的顺序展开，帮助你在不扩大破坏面的前提下恢复页面层级与附件归属。
要点总览（TL;DR）
- 先冻结源空间并导出完整备份，记录目标空间当前状态作为回退点，再开始任何删除、覆盖或批量移动操作。
- 页面树错位多与导入顺序、标题重名、跨空间引用未重写有关；附件错挂多与按页面ID关联、页面重建后ID变化有关，逐条验证后再动手。
- 问题面大时按父级优先整体重导：先空间与顶层页面，再逐层导入子页面，层级稳定后导入附件，最后重写引用并核对权限。
- 问题面小时按症状记录表局部修补：调整父级关系、以“附件名+原页面路径”重挂附件、修正引用、逐层重建权限。
- 修复后用页面树、附件挂载、权限继承三类清单逐项核对，并把症状表、原因证据表、验证清单归档为下次迁移的检查基线。
先分清两类症状：层级错位与附件错挂
修复的第一步是把“看起来乱”拆成可记录、可核对的具体现象。页面树错位和附件归属错误往往同时出现，但成因和处置方式不同，混在一起排查容易误判。建议在动手调整前，先按空间、页面、附件三个维度各抽一批样本，把现状如实记下来。
页面树错位的典型表现
- 子页面挂到了错误的父级下，例如原本属于“产品文档”的子页面出现在“市场资料”下。
- 层级被压平：原本三层以上的页面结构变成一层，所有页面平铺在空间首页下。
- 同级页面顺序混乱，与源空间的排列顺序不一致。
- 跨空间引用的页面在目标空间中丢失父级，成为孤立页面或挂到空间根节点。
附件归属错误的典型表现
- 大量附件集中挂到空间根页面或某个顶层页面，而不是各自所属的内容页。
- 附件挂到了同名页面下，尤其是多个空间存在同名页面时更容易发生。
- 附件版本数量少于源空间，历史版本在迁移中丢失。
- 正文中的图片显示为失效占位，说明图片引用没有指向迁移后的新附件地址。
区分迁移导入问题与源空间结构问题
并非所有错位都是迁移造成的。源空间本身可能存在游离页面、历史遗留的重复标题、手工调整过但未整理的结构。判断方法是回到源空间核对：如果源空间中父子关系本就如此，目标空间的呈现只是如实复制，就不属于迁移缺陷；如果源空间层级清晰而目标空间出现压平或错挂，才进入迁移问题的排查范围。这一步能避免把源端历史问题当成迁移故障反复重导。
症状记录表
逐条记录是后续验证原因和确认修复效果的基础。建议至少包含以下字段，页面与附件分开登记：
| 对象类型 | 名称 | 原位置（源空间路径） | 现位置（目标空间路径） | 期望归属 | 影响范围 |
|---|---|---|---|---|---|
| 页面 | 示例：接口规范 | 产品文档 / 技术方案 / 接口规范 | 空间根目录 | 产品文档 / 技术方案 | 该页及其 6 个子页面 |
| 附件 | 示例：架构图 v3.png | 技术方案页附件 | 空间首页附件 | 技术方案页 | 正文图片失效 2 处 |
记录时保留页面标题的原始写法（含空格、特殊字符），后续排查标题歧义时会用到。影响范围一栏写明受牵连的子页面数量或引用该附件的页面数量，用于判断走整体重导还是局部修补。
原因假设与排除证据：先验证再动手
页面树错位和附件错挂的可能原因有多条，且常常叠加出现。处置前应逐条验证，把每条假设标注为“已证实”“已排除”或“待验证”。在原因未确认前执行删除、覆盖、批量移动等操作，可能把可恢复的问题变成不可恢复的数据损失。
假设一：导入顺序未按父级优先
这是页面树压平最常见的原因。迁移工具若按页面创建时间或导出文件中的排列顺序导入，子页面可能先于父页面进入目标空间；父页面尚不存在时，导入程序通常把子页面挂到根节点或最近的可挂载节点。验证方式是比对导入日志中的处理顺序与页面创建时间顺序，检查错位页面是否集中在“父页面创建时间晚于子页面”的那一批。若错位页面与导入顺序高度吻合，该假设可判定为已证实。
假设二：标题重名或特殊字符导致挂载歧义
Confluence 允许不同空间存在同名页面，同一空间内也可能因历史原因出现重复标题。迁移时若以标题作为挂载依据，重名页面会被挂到先出现的同名节点下。验证方式是统计源空间内的同名标题数量，以及含斜杠、冒号、问号等特殊字符的标题清单，再对照错位页面是否落在这些标题上。特殊字符还可能影响路径解析，导致附件按路径匹配时失败。
假设三：附件按页面 ID 或上传顺序关联
附件与页面的关联若依赖源系统的页面 ID，而页面在目标空间重建后 ID 发生变化，关联就会断裂，附件被归入默认位置或按上传顺序挂到相邻页面。验证方式是抽查若干附件，核对“附件名—源页面—目标页面”三者是否一致，并观察错挂附件是否集中在页面重建批次中。若同一页面的附件被拆散到多个位置，ID 关联失效的可能性较高。
假设四：跨空间引用与包含宏未重写
页面中引用其他空间页面、使用包含宏或页面属性宏的内容，在迁移后若链接未重写，页面树展示和正文渲染都会异常。验证方式是打开含引用的页面，检查链接目标是否仍指向源空间地址、宏是否正常渲染。此类问题表现为“页面本身位置正确但内容显示异常”，与层级错位需要区分对待。
假设五：权限继承链未随层级迁移
空间权限与页面限制若未按原继承关系重建，会出现页面位置正确但部分成员看不到、或本应受限的页面对所有空间成员可见。验证方式是对比源空间与目标空间的权限继承链：从空间权限逐层向下核对页面限制，确认受限页面在目标空间仍保持限制状态。
原因假设与验证证据表
| 假设 | 验证方法 | 证据 | 结论 |
|---|---|---|---|
| 导入顺序未父级优先 | 比对导入日志顺序与页面创建时间 | 错位页面集中于父页面后建批次 | 已证实 / 已排除 / 待验证 |
| 标题重名或特殊字符 | 统计同名标题与特殊字符标题 | 错位页面标题命中重名清单 | 已证实 / 已排除 / 待验证 |
| 附件按 ID 关联失效 | 抽查附件与页面对应关系 | 同页附件被拆散到多处 | 已证实 / 已排除 / 待验证 |
| 引用与宏未重写 | 检查引用链接与宏渲染结果 | 链接仍指向源空间地址 | 已证实 / 已排除 / 待验证 |
| 权限继承链断裂 | 对比源目标空间权限继承链 | 受限页面在目标空间公开可见 | 已证实 / 已排除 / 待验证 |
多条假设同时成立时，处置顺序应先解决导入顺序和标题歧义这两类结构性问题，再处理附件与引用，最后核对权限。结构未稳定前重挂附件，可能因页面再次移动而白做一遍。
处置步骤：按父级优先重导与局部修补
确认原因后，根据问题覆盖面选择处置路径。错位页面占空间总量比例高、且备份完整可用时，整体重导更彻底；错位集中在少数页面、附件错挂范围有限时，局部修补的代价更低。两条路径都以前置动作为前提。
前置动作：冻结、备份、留回退点
- 暂停源空间的写入，通知相关成员在修复期间不新增或修改页面，避免源端变化导致比对基准失效。
- 导出完整空间备份，包含页面、附件与权限设置，并确认备份文件可正常打开。
- 记录目标空间当前状态：页面数量、附件数量、权限配置，作为回退点。若目标空间已有用户新增内容，先单独导出这部分内容。
路径一：问题面大时整体重导
适用于页面树大面积压平、附件集中错挂、局部修补工作量超过重导的情况。执行顺序为：
- 清空目标空间中本次导入的结果，保留用户在此期间新增的内容。
- 先建立空间与顶层页面，确认顶层结构无误。
- 按父级优先逐层导入子页面，每完成一层核对一次父子关系，再进入下一层。
- 页面层级稳定后导入附件，按“附件名 + 原页面路径”匹配挂载。
- 最后处理跨空间引用与宏的重写，并核对权限继承链。
重导过程中设置停止点：若某一层导入后出现大面积错挂，立即停止并回退到前置动作记录的回退点，不要在同一状态上反复覆盖导入。
路径二：问题面小时局部修补
适用于错位页面数量有限、附件错挂可逐条定位的情况。按症状记录表逐条处理：
- 调整父级关系：把错挂页面移动到正确父页面下，移动前确认目标父页面已存在且标题唯一。
- 重挂附件：以“附件名 + 原页面路径”为依据重新挂载到对应页面，保留附件版本；挂载后检查正文图片引用是否指向新附件，失效的图片需要重新插入或更新引用地址。
- 修正引用：把仍指向源空间地址的链接改为目标空间地址，重新渲染包含宏并确认内容完整。
- 重建权限：按源空间权限继承链，先设置空间权限，再逐层核对页面限制，确保受限页面保持限制状态。
局部修补的每一步都应在症状记录表上更新状态，避免同一页面被重复处理或遗漏。批量移动、批量删除前再次确认备份可用，并明确本次操作的停止条件，例如“单次移动超过 20 个页面即暂停复核”。
附件修复的匹配口径
附件修复的关键是建立稳定的匹配依据。以附件名加原页面路径作为主键，比单纯依赖附件名更可靠，因为不同页面可能存在同名附件。重挂完成后，逐一打开引用该附件的页面，确认图片正常显示、下载链接指向新位置。版本数量与源空间不一致的附件，需要从备份中补回历史版本。
验证与复发预防：三类清单逐项核对
修复完成不等于恢复完成，需要用清单逐项确认。验证采用抽查加全量比对结合的方式：结构类指标全量比对，内容类指标按比例抽查，抽查比例根据空间规模确定，并记录抽查结果。
页面树验证
- 抽查各层级深度，确认最深层级与源空间一致。
- 核对父子关系：随机抽取若干页面，比对源空间与目标空间的父页面是否相同。
- 核对同级页面顺序，确认与源空间排列一致。
- 检查跨空间引用页面是否已挂回正确父级，孤立页面数量是否为零。
附件验证
- 抽查附件挂载页面是否与源页面一致，重点检查同名页面下的附件。
- 核对附件版本数量，确认历史版本未丢失。
- 打开含图片的页面，确认正文图片正常显示，无失效占位。
- 抽查附件下载链接可正常访问。
权限验证
- 抽查空间权限配置与源空间一致。
- 抽查页面限制的继承结果：受限页面在目标空间仍仅对指定成员可见。
- 用不同权限的测试账号各访问一次，确认可见范围符合预期。
复发预防：下次迁移前的检查项
- 迁移前统一标题规范，清理重名页面，对含特殊字符的标题做预处理。
- 制定父级优先的导入顺序，先空间与顶层页面，再逐层导入子页面。
- 附件与页面绑定校验：迁移前导出“附件名—页面路径”对照表，迁移后逐项比对。
- 引用重写放在页面层级稳定之后执行，避免链接随页面移动反复失效。
- 把本次的症状记录表、原因验证表、验证清单归档，作为下次迁移的检查基线。
如果迁移目标是 ONES Wiki，官方资料说明 Confluence 迁移可覆盖空间、页面、附件和权限结构，迁移数据包括用户、用户组、空间权限与页面权限，并支持页面正文、附件、图片、常用宏及批注，迁移方式包括批量迁移与数据包导入。迁移完成后，页面层级、附件挂载与权限继承的日常维护可以在 ONES Wiki 中按空间和页面逐层核对；具体迁移范围与异常处置方式，以实际迁移方案和厂商确认为准。
常见问题
修复过程中发现源空间本身就有游离页面和重复标题，应该先处理哪一边？
先处理源空间的结构问题，再继续迁移修复。源空间的游离页面和重复标题会持续制造挂载歧义，在目标空间反复调整父级关系只是临时掩盖。建议在冻结写入后，于源空间完成标题去重、为游离页面指定父级，重新导出备份后再按父级优先导入。若源空间暂时无法整理，至少在症状记录表中标注这些页面，修复时按“源端历史问题”单独归类，避免与迁移缺陷混在一起反复重导。
局部修补时批量移动页面，怎样控制风险？
批量移动前确认三件事：备份可正常打开、目标父页面已存在且标题唯一、本次操作有明确的停止条件。建议分批执行，例如单次移动不超过 20 个页面，每批完成后抽查父子关系与同级顺序，确认无误再继续。移动过程中若出现大面积错挂，立即停止并回退到前置动作记录的回退点，不在同一状态上反复覆盖操作。移动完成后同步更新症状记录表的状态，避免同一页面被重复处理。
附件版本在迁移中丢失，还能补回来吗？
可以尝试从迁移前的完整空间备份中补回。附件修复以“附件名 + 原页面路径”为匹配依据重新挂载，挂载后核对版本数量是否与源空间一致；缺失的历史版本从备份中提取后重新上传到对应页面。补回后逐一打开引用该附件的页面，确认正文图片正常显示、下载链接指向新位置。若备份中版本本身不完整，需要回到源空间确认原始版本情况，再决定是否接受当前版本状态。
页面位置正确但部分成员看不到，属于哪类问题？
这通常属于权限继承链问题，而非页面树错位。迁移时空间权限与页面限制若未按原继承关系重建，会出现页面位置正确但可见范围异常。验证方式是对比源空间与目标空间的权限继承链：从空间权限逐层向下核对页面限制，确认受限页面在目标空间仍保持限制状态。修复时先设置空间权限，再逐层核对页面限制，最后用不同权限的测试账号各访问一次确认可见范围。若迁移目标是 ONES Wiki，官方资料说明迁移数据包括用户、用户组、空间权限与页面权限，迁移后仍需按上述方式逐层核对。
下次迁移前，哪些检查项最能减少页面树错位和附件错挂？
优先做四项：统一标题规范并清理重名页面，对含特殊字符的标题做预处理；制定父级优先的导入顺序，先空间与顶层页面再逐层导入子页面；迁移前导出“附件名—页面路径”对照表，迁移后逐项比对附件挂载；把引用重写放在页面层级稳定之后执行。这四项分别对应标题歧义、导入顺序、附件关联和引用失效四类常见成因。把本次的症状记录表、原因验证表和验证清单归档，可作为下次迁移的检查基线。
