Confluence 空间迁移可以按“定范围—盘资产—建映射—试迁移—校验—切换与回退”推进。先确定要迁的空间、页面树、附件、权限和历史版本边界，再建立字段映射规则，用一个小空间跑通流程，凭数量、内容、链接和权限证据验收，最后分批切换并保留旧站只读回退窗口。迁移任务、映射表和校验记录可以统一纳入 ONES 跟踪。
要点总览（TL;DR）
- Confluence 空间迁移按“定范围—盘资产—建映射—试迁移—校验—切换与回退”推进，范围清单是后续数量核验的基准。
- 动手前确认源站管理员权限、目标空间创建权限和导出方式；整空间迁移常用空间导出包，按条件筛选或增量同步可用 API 拉取。
- 页面层级、正文格式、附件引用、元数据和权限要逐类写成映射表，同名不同义项单独标注，宏和插件场景逐项评估。
- 选一个结构典型、体量可控的小空间试迁移，记录失败项和人工修复工时，再修订映射规则与批次划分。
- 切换前用页面数、附件数、抽样渲染、链接可达性和按角色访问验证出校验证据，并写明回退触发条件与责任人。
迁移范围：哪些空间、页面和附件要迁
迁移范围决定后续工作量、校验口径和切换批次。第一步要确认源 Confluence 站点与目标平台的版本和部署方式，例如源站是云版还是数据中心版，目标侧是 SaaS 还是私有部署。版本与部署方式会影响导出方式、API 可用性和权限模型，需在动手前核实。
空间清单按业务归属、活跃度和负责人筛选。建议把全部空间分为三类：本次迁移、延后迁移、不迁移。判断依据可以包括近半年访问与编辑频率、是否有明确负责人、是否已被其他知识库替代、是否包含合规敏感内容。每个空间记录负责人和迁移优先级，避免只按空间名称排序。
空间内对象要逐类清点，形成带对象类型和数量的清单：
| 对象类型 | 清点内容 | 处理决定 |
|---|---|---|
| 页面树 | 父页面、子页面层级、页面总数 | 迁移、合并或归档 |
| 正文内容 | 富文本、表格、代码块、宏、嵌入内容 | 按格式映射规则处理 |
| 附件与图片 | 文件名、大小、引用位置、重复文件 | 迁移并重建引用 |
| 评论与批注 | 页面评论、行内批注数量 | 确认目标侧承载方式 |
| 历史版本 | 版本数量、关键版本节点 | 明确是否保留及保留范围 |
| 标签与页面状态 | 标签、页面状态、模板 | 映射为目标标签或属性 |
| 权限与用户组 | 空间权限、页面限制、外部协作者 | 映射为目标角色与用户组 |
权限对象容易被漏掉。空间权限、页面限制和外部协作者要单独列出，尤其是仅对个别用户开放的页面。外部协作者是否保留访问，需要业务负责人确认，不能默认延续。
不迁或延后迁的内容要写明理由，例如长期无人维护的归档空间、依赖特定插件的页面、包含历史敏感信息的附件。范围清单完成后，由各空间负责人确认签字，作为后续数量核验的基准。
迁移前要准备什么：账号、权限与导出方式
动手前需要拿到源站管理员权限和目标平台的空间创建权限。源站管理员权限用于导出空间、读取权限配置和查看用户组；目标侧权限用于提前建好空间结构、用户和用户组。缺少任一项都会导致迁移中途停摆。
导出方式主要有三类，适用条件不同：
- 空间导出包：适合整空间迁移，能一次性带出页面树、附件和部分元数据，适合体量较大、结构完整的空间。需要确认导出包格式与目标平台导入能力的匹配关系。
- API 拉取：适合需要按条件筛选页面、分批处理或做增量同步的场景，灵活度高，但需要开发或脚本支持，并处理分页、限流和附件下载。
- 逐页导出：适合页面数量少、结构简单的空间，或作为个别页面的补救手段，人工成本高，不适合大规模迁移。
目标侧要先建好空间结构、用户与用户组。用户可以先按源站账号清单创建或对接企业账号体系，用户组按权限映射方案预建。空间目录结构在试迁移前搭好，避免迁移后反复调整层级。
迁移窗口要提前约定。对活跃空间，可安排停机或只读窗口，在窗口内完成最终增量迁移；对访问量低的空间，可以在业务低峰期分批处理。窗口长度根据试点测得的单位页面处理时间估算，并预留人工修复时间。
备份与回滚依赖源站快照。迁移前对源站做完整备份或确认已有可用快照，记录备份时间和恢复方式。旧站在切换后保留只读访问，作为回退兜底。
字段与结构映射：页面、附件、权限怎么对应
映射规则要在试迁移前写成表，按“源字段—目标字段—转换规则—负责人”四列维护。同名不同义是最常见的问题，例如源站的“空间”对应目标平台的“知识库”还是“目录”，源站的“页面限制”对应目标平台的页面权限还是空间角色，都要在表中写清楚。
页面层级映射先定根节点。每个 Confluence 空间落到目标平台的一个空间或知识库，空间内的顶层页面作为一级目录，子页面按原有父子关系挂接。遇到跨空间引用的页面，记录原空间和页面 ID，迁移后统一改为目标地址。
正文格式映射按内容类型分别处理：
| 源内容 | 映射策略 | 需人工处理的情况 |
|---|---|---|
| 普通富文本 | 直接转换，保留标题、列表、加粗等基础格式 | 复杂嵌套样式 |
| 表格 | 转换为目标表格，核对合并单元格 | 超宽表格、嵌套表格 |
| 代码块 | 保留语言标识和内容 | 特殊高亮插件 |
| 宏 | 常用宏按目标能力替换，其余登记 | 插件宏、自定义宏 |
| 嵌入内容 | 转为附件或链接 | 外部嵌入、iframe |
宏的处理要特别谨慎。迁移前逐项评估空间内使用的宏类型，确认哪些能自动转换、哪些需要替换为目标平台的等效能力、哪些只能降级为文本或链接。依赖插件的定制场景要逐项评估，避免假设所有插件都能一一对应。
附件与图片按文件名和原页面引用关系重建。重名文件在目标侧加前缀或目录区分，图片引用改为目标附件地址。迁移后抽查图片是否正常显示、附件能否下载。
元数据映射包括作者、创建与修改时间、标签和页面状态。作者按账号映射表对应到目标用户，时间字段确认目标平台是否保留原始时间。标签转为目标标签，页面状态按目标平台的状态机制处理。
权限映射把源站空间权限、页面限制对应到目标角色与用户组。先列角色对照表，再列用户组对照表，最后处理个别用户的页面级授权。无法自动映射的权限项登记到人工处理清单，由空间负责人逐项确认。
试迁移怎么做：选一个小空间跑通全流程
试点空间要结构典型、体量可控、有明确验收人。典型意味着包含页面树、附件、表格、代码块和常用宏，能覆盖主要映射规则；体量可控意味着页面和附件数量在可人工核对范围内；验收人由空间负责人担任，能判断内容是否正确。
试迁移按“结构—页面—附件—权限—元数据”的顺序执行。先建空间和目录骨架，再导入页面正文，然后补齐附件和图片引用，接着配置权限，最后核对作者、时间和标签。每步完成后记录成功与失败数量。
失败项要记录现象、原因和人工修复工时。例如某个宏无法转换，记录宏名称、出现页面数和替代方案；某张图片引用断裂，记录原路径和目标路径。修复工时用于估算全量迁移的人力投入。
试点结束后修订映射规则和批次划分。如果发现某类页面人工修复比例过高，可以调整批次，把这类页面集中处理或延后；如果权限映射出现越权或漏权，先修正规则再放大迁移范围。
迁移后怎么核验：用证据判断是否通过
核验要拿证据说话，避免只凭浏览感觉验收。数量核验把目标侧页面数、附件数、评论数与源站清单比对，差异逐条记录。数量一致是基础，数量不符要先查清是漏迁、重复还是源站清单本身有误。
内容核验按抽样清单进行。抽样覆盖不同类型页面：普通文档、含表格页面、含代码块页面、含宏页面、含附件页面。检查正文格式、宏渲染、表格结构和代码块显示是否正常，发现问题记录页面地址和差异描述。
链接核验分三类：内部链接、跨空间链接和外部链接。内部链接检查是否指向正确页面，跨空间链接检查目标空间是否已迁移，外部链接检查是否可达。批量检查可用链接扫描工具辅助，结果仍需人工确认关键页面。
权限核验按角色实际访问验证。用空间负责人、普通成员、受限用户等角色分别登录，访问关键页面，确认该看到的能看到、不该看到的无法访问。权限越权属于高风险问题，发现后暂停该批次切换。
用户确认由空间负责人完成。负责人对照抽样清单检查内容，签署书面确认或在迁移任务中标记验收通过。校验报告汇总数量比对结果、抽样清单、差异记录和处理状态，作为切换依据。
切换与回退：分批上线和停止条件
切换按批次进行，每批包含若干空间，按业务重要性和依赖关系排序。建议先切换依赖少、访问量低的空间，再切换核心空间。每批切换后设置观察期，观察期内收集用户反馈和访问异常，确认稳定后再进入下一批。
旧站保留只读访问一段时间，访问方式提前通知用户。只读期间旧站不再接受编辑，新内容统一写入目标平台。只读窗口长度根据业务节奏确定，核心空间可适当延长。
回退触发条件要提前写清楚，例如关键页面缺失、权限越权、附件大面积下载失败、核心链接不可达。触发后由迁移负责人决定暂停当前批次或回退到旧站。回退操作步骤包括恢复旧站编辑权限、通知用户切换回旧地址、记录回退原因和影响范围，责任人为迁移负责人和 IT 管理员。
迁移完成后处理旧站归档与链接重定向。旧站转为归档状态，保留查询能力；常用入口链接重定向到目标平台对应页面，减少用户找不到内容的情况。归档前确认没有遗漏的待迁内容。
迁移过程中的协作与记录怎么管
迁移是有角色、有状态、有交接的项目。角色分工至少包括迁移负责人、空间负责人、IT/权限管理员和验收人。迁移负责人统筹计划、批次和回退决策；空间负责人确认范围和内容验收；IT/权限管理员处理账号、用户组和权限映射；验收人按校验清单逐项确认。
把迁移任务拆成工作项并跟踪状态，状态可以设为待盘点、映射完成、试迁通过、已校验、已切换。每个空间对应一组工作项，失败项指派到人并记录处理结果。这样切换前能清楚看到哪些空间还没通过校验。
映射表、校验报告和回退预案作为文档与工作项关联。工作项里直接链接对应文档，交接时不用反复查找。ONES 可以承载这部分管理动作：迁移任务作为工作项跟踪状态，映射表和校验报告作为 Wiki 文档与工作项关联，问题登记后指派给责任人并记录处理结果。Confluence 空间、页面、附件和权限结构迁移到 ONES Wiki 时，用户、用户组、空间权限与页面权限，以及页面正文、附件、图片、常用宏和批注属于可迁移范围；历史版本、标签、页面状态等对象是否覆盖，以及常用宏的具体清单，需要在项目启动前向原厂确认。
问题登记与交接要形成闭环。每个失败项记录来源空间、页面地址、问题类型、责任人和处理状态，处理完成后由验收人复核。批次切换前开一次交接会，确认未关闭问题的处理方案和回退预案，再进入上线。
常见问题
Confluence 空间迁移时，历史版本、评论和标签要不要一起迁？
这三类对象建议在范围清单阶段单独列出，由空间负责人逐项决定。历史版本影响存储量和迁移时长，可以只保留关键版本节点；评论和批注要确认目标平台的承载方式；标签和页面状态需要对应到目标平台的标签或属性机制。
如果目标平台对某类对象的覆盖范围尚不明确，先在试点空间验证，再决定全量迁移时是否保留。范围清单里写清“迁、降级、不迁”三种处理方式，后续数量核验才有依据。
空间导出包和 API 拉取应该怎么选？
整空间结构完整、体量较大时，空间导出包更省事，能一次带出页面树、附件和部分元数据，但要先确认导出包格式与目标平台导入能力的匹配关系。需要按条件筛选页面、分批处理或做增量同步时，API 拉取更灵活，代价是要处理分页、限流和附件下载，通常需要脚本或开发支持。
两种方式也可以组合：首轮用导出包完成主体迁移，切换前用 API 拉取补齐增量页面。无论选哪种，都先在试点空间跑一遍，确认失败项和人工修复工时。
迁移后权限出现越权或漏权，应该怎么处理？
权限问题按高风险处理。发现越权或漏权后，先暂停该批次切换，把问题页面、涉及角色和实际访问结果记录到校验报告，再回到权限映射表检查是角色对照错误、用户组遗漏还是页面级授权未处理。
修正后重新按角色实际访问验证：空间负责人、普通成员、受限用户分别登录，确认该看到的能看到、不该看到的无法访问。权限核验通过前，不进入下一批切换。
试点空间迁移通过了，全量迁移还会出问题吗？
试点能验证主要映射规则，全量阶段仍可能遇到试点未覆盖的情况，例如特殊宏、超宽表格、跨空间引用和外部嵌入内容。建议在批次划分时把结构特殊的空间单独成批，安排更多人工修复时间。
每批切换后设置观察期，收集用户反馈和访问异常。发现同类问题反复出现时，先修订映射规则再继续下一批，避免问题在多个空间重复放大。
旧站只读窗口要保留多久，什么时候可以归档？
只读窗口长度按业务节奏确定，核心空间可以适当延长，让用户有时间适应新地址和反馈遗漏内容。窗口内旧站不再接受编辑，新内容统一写入目标平台。
归档前确认三件事：待迁内容没有遗漏、常用入口链接已重定向到目标页面、未关闭问题都有处理结论。确认后再把旧站转为归档状态，保留查询能力。
