从 Confluence 迁出，关键是把“空间—页面树—权限—附件—宏与内嵌内容—历史版本”逐层盘点成清单，先确定目标平台和保留范围，再做字段与结构映射、小范围试迁移，最后按页面完整性、链接可达性、权限一致性和附件可用性逐项校验，并预设回退点。整个过程以 Confluence 为来源、目标平台为落点，无法承诺零损或一键完成；如果目标选在 ONES Wiki，其迁移方案覆盖空间、页面、附件与权限结构，可作为映射和核验的参照。
要点总览（TL;DR）
- 先确定目标平台再盘点：按空间、页面树、附件、宏与内嵌内容、历史版本逐层列出清单，并写明不迁移内容及留存位置。
- 映射表要覆盖结构、标题、正文、标签、作者与时间、权限、附件和宏；同名字段含义不同时，用源端定义、目标端定义和业务用途三方对照，无法判定的交业务确认人签字。
- 试迁移选取层级深、宏密集、权限复杂、附件多的代表性样本，四项通过标准全部满足后再冻结映射规则进入全量。
- 核验以证据为准：页面数量与内容、内部链接、附件可达性、权限抽查、版本与评论保留逐项留存记录，核验人与执行人分离。
- 切换前设置源端只读冻结时点、旧链接跳转规则和回退触发条件，回退方式提前演练；试迁移多轮不达标时应暂停并重新评估目标平台或保留范围。
迁出范围怎么定：空间、页面与历史版本
迁移范围的第一步是确定目标平台。目标平台决定了导入格式、字段结构和权限模型，目标未定时做盘点，清单会反复返工。目标确定后，再按空间和页面树划定批次，避免把整个 Confluence 站点不加区分地搬走。
建议按以下顺序盘点来源对象：
- 空间清单：列出全部空间，标注业务归属、活跃程度、页面数量和负责人，区分在用空间、归档空间和废弃空间。
- 页面树：对每个纳入迁移的空间导出页面层级，记录父子关系、页面标题和页面 ID，作为后续结构映射的底稿。
- 附件与图片：统计附件数量、总容量和大文件分布，单独标记被多个页面引用的公共附件。
- 宏与内嵌内容：逐页记录使用的宏类型，重点标注内嵌页面、目录、状态、任务列表、图表等依赖其他页面或外部服务的宏。
- 历史版本与评论：记录各页面的版本数量和评论数量，判断哪些页面的历史对审计或追溯有实际价值。
保留取舍需要逐类给出结论，并写进范围清单。历史版本通常只对制度、合同、架构决策等需要追溯的页面保留，普通协作页可只迁当前版本；评论按业务价值筛选，讨论结论已沉淀进正文的评论可以舍弃；宏按类型判断，能转为目标平台原生内容的保留，依赖外部服务的宏列入降级清单。范围清单应同时包含“不迁移内容”一栏，例如废弃空间、个人草稿、测试页面、临时附件，写明不迁移的理由和留存位置，避免切换后被误认为丢失。
迁移前要准备哪些输入与依赖
迁移执行前需要把输入和依赖核对齐全，缺少任何一项都可能导致映射返工。建议用一张核对表逐项确认责任人和完成状态。
| 输入项 | 需要确认的内容 | 缺失的后果 |
|---|---|---|
| 源端导出能力 | Confluence 版本与部署形态、可用的导出方式（空间导出、页面导出、API 拉取）、导出格式 | 导出格式与目标导入格式不匹配，需重新导出 |
| 目标平台导入格式 | 支持的导入包结构、字段定义、附件存放规则、宏转换能力 | 字段映射无法落地，试迁移反复失败 |
| 权限模型 | 源端空间权限与页面权限的继承关系、目标平台的角色与权限组定义 | 迁移后出现越权可见或内容不可见 |
| 用户账号对应 | Confluence 用户与目标平台账号的对应表，含离职账号、外部协作者账号的处理方式 | 作者信息丢失，权限归属错乱 |
| 负责人与时间窗 | 迁移负责人、各空间业务确认人、可用的停机或低峰时间窗 | 切换时无人确认，问题积压 |
| 写入冻结安排 | 源端停止编辑的时点、冻结期间新内容的临时存放方式 | 冻结后仍有修改，迁移数据与源端不一致 |
其中权限模型和账号对应关系最容易在后期暴露问题。Confluence 的空间权限、页面限制和用户组往往层层继承，目标平台若采用角色制，需要先把“谁在什么范围内能看、能编辑”翻译成目标平台的角色语言，再核对每个用户的实际可见范围。写入冻结要提前通知到所有编辑者，并明确冻结期间的新内容是先记录待补，还是等切换完成后再补录。
同名字段含义不同时如何做映射
映射的核心是把源端结构、字段、权限和内容逐项对应到目标平台，并对语义差异给出处理方式。页面树通常映射为目标平台的目录或父子页面层级，映射时保留原有父子关系，层级过深的分支可合并中间层，但要在映射表中注明合并位置，方便核验时回溯。
| 映射对象 | 源端（Confluence） | 目标端处理方式 | 差异说明 |
|---|---|---|---|
| 结构 | 空间—页面—子页面 | 空间对应知识库或目录，页面树对应父子页面 | 层级深度限制需提前确认 |
| 标题 | 页面标题 | 直接对应，重名时加空间前缀 | 同一目录下不允许重名 |
| 正文 | 富文本与宏组合 | 转为目标平台富文本，宏按类型转换或降级 | 复杂宏可能转为静态内容或链接 |
| 标签 | 页面标签 | 对应标签字段，无对应字段时写入正文属性区 | 标签体系可能不通用 |
| 作者与时间 | 创建人、最后修改人、创建与修改时间 | 对应作者字段与时间字段，系统字段不可改时记入备注 | 目标平台可能只保留导入时间 |
| 权限 | 空间权限、页面限制、用户组 | 映射为目标平台角色与权限组 | 继承关系需逐层还原 |
| 附件与图片 | 页面附件、内嵌图片 | 随页面迁移，正文引用改为目标地址 | 外链附件需单独处理 |
| 宏与内嵌页面 | 目录、状态、任务列表、内嵌页面等 | 可转换的转原生组件，不可转换的降级为文本或链接 | 降级内容需人工复核 |
同名字段含义不同是最需要人工确认的部分。例如源端的“作者”指页面创建人，目标端的“负责人”指当前维护人，两者不能直接对应；源端的“标签”是自由词，目标端的“分类”是受控词表，直接导入会产生大量无效值。判定方法是把源端字段定义、目标端字段定义和业务实际用途三方对照，能自动判定的写入映射规则，无法判定的列入人工确认清单，由各空间业务确认人逐条签字。宏和内嵌页面的降级处理同样要进清单：内嵌页面在目标平台若无法动态嵌入，改为链接并注明原页面；依赖外部服务的宏改为说明文字加截图，保留信息可读性。
如果目标平台是 ONES Wiki，其 Confluence 迁移方案支持迁移页面正文、附件、图片、常用宏及批注，并迁移用户、用户组、空间权限与页面权限，可作为映射表的参照；宏仅覆盖常用类型，具体宏清单仍需在迁移前逐项核对，历史版本与评论的保留程度也要在试迁移中实测确认。
试迁移怎么做：小批量验证映射
试迁移的目的是用代表性样本验证映射规则，在暴露问题后再决定是否全量执行。样本选择应覆盖不同类型，而不是只挑结构简单的页面。
- 选一个页面层级较深、子页面较多的空间，验证结构映射；
- 选一个宏使用密集的空间，验证宏转换与降级；
- 选一个权限设置复杂的空间，验证权限组与角色映射；
- 选一个附件多、含大文件的空间，验证附件迁移与链接改写；
- 选若干含历史版本和评论的页面，验证保留情况。
执行顺序建议为：先导出样本数据，按映射表导入目标平台，再逐页比对内容、结构和权限，最后记录问题。问题记录要写清页面、字段、预期结果和实际结果，并归入三类：映射规则错误、目标平台能力限制、源端数据本身异常。前两类需要修订映射规则或调整降级方案，第三类在范围清单中标注处理方式。
试迁移通过标准应覆盖四项：样本页面数量与内容完整导入，内部链接和附件可正常打开，权限抽查结果与源端一致，历史版本与评论按范围清单保留。四项全部通过后，映射规则冻结，进入全量迁移；任一项不通过，先修订规则再重跑样本，不带问题进入全量。
迁移后如何核验：证据与通过标准
核验以证据记录为准，逐项留存检查结果，避免只凭“看起来没问题”判断完成。建议按下表组织核验。
| 核验项 | 检查方法 | 通过标准 | 证据留存 |
|---|---|---|---|
| 页面数量与内容 | 按空间比对源端与目标端页面清单，抽查正文段落、表格、图片 | 数量与范围清单一致，抽查页面内容无缺失 | 页面清单比对表、抽查截图 |
| 内部链接 | 批量检查页面间链接与锚点 | 链接可打开，失效链接有记录和处理结论 | 链接检查结果清单 |
| 附件可达性 | 抽查附件下载与正文内图片显示 | 附件可下载，图片正常显示 | 抽查记录 |
| 权限与可见范围 | 用不同角色账号登录抽查空间和页面 | 可见范围与源端一致，无越权暴露 | 角色抽查记录 |
| 历史版本与评论 | 对照范围清单检查保留页面 | 按清单保留，舍弃项有说明 | 版本与评论核对表 |
每项核验都要指定责任人，核验人应与迁移执行人分离，业务空间的确认人负责确认内容完整性。核验中发现的问题按严重程度分级：影响内容可用性的问题在切换前修复，仅影响展示样式的问题可记录后分批处理。核验记录汇总成验收报告，作为切换决策的依据。
切换与回退：什么条件下暂停或退回
切换前先设置源端只读冻结时点，冻结开始后 Confluence 不再接受编辑，新内容记录待补。切换时点应选在业务低峰，并提前通知所有使用者。切换完成后，旧链接需要通过跳转规则指向目标平台对应页面，通知中应说明新入口、旧链接处理方式和问题反馈渠道。
回退触发条件要在切换前写清楚，常见条件包括：核心空间页面缺失或大面积内容异常，权限抽查发现越权可见，关键附件无法访问且短时间无法修复，用户无法登录或找不到常用页面导致业务中断。触发后按预案回退：恢复源端写入、保留目标平台数据用于排查、通知使用者回到原入口。回退方式应在切换前演练一次，确认恢复写入和通知流程可用。
停止迁移的判断标准同样需要预设：如果试迁移多轮仍无法达到通过标准，或目标平台对关键宏、权限模型的支持与业务要求差距过大，应暂停全量迁移，重新评估目标平台或调整保留范围，而不是带着已知缺陷强行切换。迁移工具、迁移服务和分阶段切换结合使用，可以降低数据丢失和业务中断的风险，但最终是否切换仍以核验证据为准。
常见问题
Confluence 的历史版本和评论需要全部迁走吗？
按追溯价值逐类决定，不必全部保留。制度、合同、架构决策等需要审计追溯的页面保留历史版本，普通协作页可只迁当前版本；评论中讨论结论已沉淀进正文的可以舍弃，仍有未决事项的评论随页面保留。取舍结论写进范围清单，并在核验阶段对照清单检查保留情况。如果目标平台是 ONES Wiki，其迁移方案明确覆盖批注，历史版本与评论的具体保留程度建议在试迁移中实测确认后再定全量规则。
源端还在持续编辑，迁移期间的新内容怎么处理？
先约定写入冻结时点，冻结开始后 Confluence 停止编辑，冻结期间产生的新内容统一记录为待补清单，等切换完成后再补录到目标平台。冻结通知要提前发到所有编辑者，并说明待补内容的登记入口和责任人。如果业务无法接受长时间冻结，可以把迁移拆成多个批次，每批只冻结对应空间，缩短单次冻结窗口。
试迁移通过后全量迁移仍出现问题，应该回退还是继续修？
先判断问题性质。属于映射规则遗漏的，修订规则后对受影响范围重跑，不必整体回退；属于目标平台对关键宏或权限模型支持不足的，继续修可能反复投入，应暂停全量迁移，重新评估目标平台或调整保留范围。切换后若出现核心空间大面积内容异常、越权可见或关键附件无法访问，按预案回退：恢复源端写入、保留目标平台数据用于排查、通知使用者回到原入口。
旧页面的链接在切换后打不开，怎么减少对使用者的影响？
切换前建立旧链接到新页面的跳转规则，覆盖常用入口和文档中被引用的页面地址；无法自动跳转的，在通知中给出新入口和检索方式。核验阶段批量检查页面间链接与锚点，失效链接逐条记录处理结论。对依赖外部服务或无法动态嵌入的内嵌页面，改为链接并注明原页面，保证信息仍可追溯。
目标平台选 ONES Wiki 时，迁移前需要重点核对什么？
ONES 的 Confluence 迁移方案支持迁移页面正文、附件、图片、常用宏及批注，并迁移用户、用户组、空间权限与页面权限，可作为映射表的参照。需要重点核对的是宏的覆盖范围：方案覆盖常用宏，具体宏类型要在迁移前逐项比对，不兼容的宏提前确定降级方式；同时确认 Confluence 版本与部署形态是否在支持范围内，这两项建议在试迁移前向原厂确认。
