Confluence 空间迁移前核对清单：空间、页面树、附件与权限

Confluence 空间迁移前的准备，核心是把“迁什么、迁成什么样、谁确认”固化成一份可勾选的清单。迁移负责人可以按空间与页面树、附件与链接、权限与账号、元数据与字段映射、试迁移验收五个核对域逐项检查，每项都写明通过标准、证据和负责人；未通过且影响迁移结果的项目按阻断项处理，清零后才进入正式迁移。

要点总览（TL;DR）

• 迁移前准备按五个核对域组织：空间与页面树、附件与链接、权限与账号、元数据与字段映射、试迁移验收，每项写明通过标准、证据和负责人。
• 空间盘点要落到每个空间的迁移结论（迁移、部分迁移、归档不迁移、废弃删除），页面树需记录父子关系、跨空间引用、归档页与草稿处置。
• 附件核对重点是总量与单文件大小分布，超限大文件须有处置方案；内部链接与外部链接分别建清单并标注失效风险。
• 权限核对以受限页面清单和账号映射表为核心，正式切换前账号映射不允许存在待确认项。
• 阻断项包括空间清单未确认、权限映射缺失、大附件无处置方案、试迁移差异未闭环，全部清零并归档签字记录后才可放行正式迁移。

谁在什么时点使用这份清单

这份清单面向迁移负责人、空间管理员、内容所有者和 IT/安全人员四类角色。迁移负责人掌握整体节奏和放行判断，空间管理员提供空间结构与权限现状，内容所有者确认页面、附件和模板的去留，IT/安全负责账号映射、访问控制和数据合规。角色分工要在启动会上确认到人，避免核对时出现“都以为对方在管”的空档。

清单在三个时点使用。第一次在冻结变更前，用于确认迁移范围和盘点口径，此时重点核对空间清单和页面树；第二次在试迁移前，用于确认附件、链接、权限和字段映射已具备可验证的条件；第三次在正式切换前，用于确认试迁移差异已闭环、阻断项已清零。三个时点之间不建议跳过，否则问题会集中暴露在切换窗口内。

清单和交接模板要分开维护。清单回答“这一项是否达到通过标准”，产出的是通过/不通过结论和证据；交接模板回答“交接了什么内容”，记录空间负责人、内容范围、特殊约定和接收方。把两者混在一张表里，容易出现记录很全但无人判断是否放行的情况。

角色	介入时点	核对范围
迁移负责人	三个时点全程	整体进度、阻断项判定、放行签字
空间管理员	冻结变更前、试迁移前	空间清单、页面树、空间权限与页面级限制
内容所有者	冻结变更前、试迁移前	页面去留、附件处置、模板与标签使用情况
IT/安全	试迁移前、正式切换前	账号映射、外部协作者与匿名访问处置、合规要求

空间与页面树盘点核对项

盘点的目标是把迁移范围变成一份有结论的空间清单。每个空间至少记录空间键、名称、负责人、近一段时间的活跃度（可用页面更新频率或访问情况判断）以及迁移结论：迁移、部分迁移、归档不迁移、废弃删除。空间键和名称要按源端原样记录，便于后续对照，不要在这一步做重命名。

页面树要记录层级和父子关系，并标注跨空间引用页面的情况。跨空间引用在迁移后容易断链，需要在盘点阶段单独列出引用关系，作为链接核对的输入。页面数量统计要说明口径：是否包含子页面、是否包含归档页、是否包含草稿。层级深度也要统计，过深的页面树在目标端可能需要调整结构，提前记录可以避免迁移后返工。

归档页、草稿和废弃页面要逐类给出处置结论。常见做法是归档页随空间迁移并保留标识，草稿由内容所有者确认后删除或合并，废弃页面在冻结前完成清理并留档。处置结论要落到具体页面或页面范围，不能只写“草稿统一不迁”。

本节的通过标准是：每个空间都有明确的迁移结论和负责人；页面树可以完整还原，跨空间引用、归档页和草稿均有记录和处置结论；页面数量与层级深度按统一口径完成统计。

检查项	通过标准	证据	负责人	阻断
空间清单完整性	每个空间有空间键、名称、负责人、活跃度和迁移结论	空间清单表	空间管理员	是
页面树结构记录	父子关系与层级深度可还原，跨空间引用单独列出	页面树导出或结构截图	空间管理员	是
归档页与草稿处置	每类页面有处置结论并落到页面范围	处置结论记录	内容所有者	否
数量统计口径	页面数量统计口径统一并注明是否含子页、归档、草稿	统计说明	迁移负责人	否

附件、图片与链接核对项

附件核对先看总量和大小分布。统计附件总数量、总体积，以及单文件大小分布，重点识别超过目标端单文件限制的大文件。大文件要有明确处置方案：压缩后迁移、转存到文件服务并在页面中保留访问入口、或确认不迁移并登记原因。方案要写清执行人和完成时间，不能停留在“后续处理”。

图片、嵌入文件和宏要逐类清点。图片通常随页面迁移，但引用方式不同的图片需要单独确认；嵌入的表格、绘图、第三方内容要按类型统计数量，并标注哪些属于常用宏、哪些属于定制或第三方嵌入。存在插件或定制场景时，迁移前需要逐项评估，避免假设所有插件都能一一对应。

链接清单分内部链接和外部链接。内部链接记录源页面与目标页面，迁移后逐条验证是否可达；外部链接记录域名和用途，标注可能失效的风险。链接核对的结果要能回答两个问题：哪些链接迁移后需要人工修复，哪些链接的失效可以接受。

本节的通过标准是：附件有完整清单且大文件均有处置方案；图片、嵌入内容和宏按类型完成清点；内部与外部链接均有清单和失效风险标注；无法迁移的项目已登记处置方式。

检查项	通过标准	证据	负责人	阻断
附件总量与大小分布	总量、体积、大文件清单完整	附件统计表	空间管理员	否
大文件处置方案	每个超限文件有处置方式和执行人	处置方案记录	内容所有者	是
宏与嵌入内容清点	按类型统计数量并标注定制项	宏与嵌入清单	空间管理员	否
内部链接清单	记录源页面与目标页面，可逐条验证	链接清单	内容所有者	否
外部链接风险标注	失效风险已标注并有接受结论	风险标注记录	迁移负责人	否

权限、可见范围与账号核对项

权限核对从空间权限和页面级限制两条线展开。空间权限记录每个空间的用户和用户组授权情况，页面级限制单独导出受限页面清单，包括限制类型和受限对象。导出后要与空间管理员逐空间确认，确保清单覆盖全部受限页面，而不是只覆盖活跃空间。

账号映射表是这一节的核心交付物。表中列出源端用户、用户组、目标端账号和映射状态，外部协作者、已离职账号、服务账号要单独标记。映射状态分为已确认、待确认、不迁移三类，正式切换前不允许存在待确认项。匿名访问和公开链接的处置也要有结论：关闭、改为登录可见、或保留并说明理由。

本节的通过标准是：权限映射表覆盖全部受限页面；账号映射无未决项；外部协作者、匿名访问和受限页面均有处置结论并经 IT/安全确认。

检查项	通过标准	证据	负责人	阻断
空间权限导出	每个迁移空间有权限清单	权限导出表	空间管理员	是
页面级限制清单	受限页面全覆盖，限制对象明确	受限页面清单	空间管理员	是
账号映射表	无待确认项，特殊账号单独标记	账号映射表	IT/安全	是
匿名访问与外部协作者	每项有处置结论和确认人	处置结论记录	IT/安全	否

元数据、模板与字段映射核对项

元数据核对先清点使用情况：标签、页面属性、模板和蓝图分别在哪些空间使用、使用频率如何、是否承载了业务流程。清点结果决定映射的优先级，高频使用的模板和属性需要优先确认落位方式，低频或历史遗留项可以降级处理。

字段映射表按“源端字段—目标端字段—映射结论”三列维护。映射结论分为直接映射、转换后映射、降级处理、不迁移四类。无法映射的字段要有降级方案，常见做法是转为正文中的说明段落、作为附件保留、或转为标签便于检索。降级方案要经内容所有者确认，避免迁移后关键信息只剩一个字段名。

本节的通过标准是：标签、页面属性、模板与蓝图完成使用情况清点；每个字段有映射结论；降级项已确认并有接收方式。

检查项	通过标准	证据	负责人	阻断
标签与页面属性清点	使用范围和频率有统计	清点表	空间管理员	否
模板与蓝图清点	列出使用空间和业务用途	模板清单	内容所有者	否
字段映射表	每个字段有映射结论	字段映射表	迁移负责人	是
降级方案确认	降级项有接收方式和确认人	降级方案记录	内容所有者	否

试迁移与验收核对项

试迁移用样本空间验证前面几节清单的执行结果。样本空间的选择标准是覆盖主要页面类型：普通页面、含附件的页面、含宏或嵌入内容的页面、受限页面、使用模板创建的页面，以及存在跨空间引用的页面。样本不必追求数量多，但要能暴露结构、附件、链接和权限四类问题。

试迁移完成后逐项比对：页面树层级是否与源端一致，页面正文和批注是否完整，附件数量和大小是否匹配，内部链接是否可达，受限页面的可见范围是否与映射表一致。比对结果记入验收记录表，差异分为“需修复”和“可接受”两类，需修复项要指定修复人和复验时间，形成闭环。

本节的通过标准是：样本空间覆盖主要页面类型；页面树、附件、链接、权限逐项完成比对；差异全部登记，需修复项已闭环或明确复验安排。

检查项	通过标准	证据	负责人	阻断
样本空间覆盖度	覆盖普通页、附件页、宏页、受限页、模板页	样本清单	迁移负责人	是
页面树比对	层级与父子关系一致或有登记差异	比对记录	空间管理员	是
附件与链接比对	数量、大小、可达性逐项核对	比对记录	内容所有者	是
权限比对	受限页面可见范围与映射表一致	权限比对记录	IT/安全	是
差异闭环	需修复项有修复人和复验时间	差异跟踪表	迁移负责人	是

试迁移产生的差异记录、字段映射表和空间清单，需要有人持续跟踪状态。采用 ONES 作为目标端时，这些核对结果可以作为工作项登记，按空间或差异类型分配负责人，用状态流转记录从发现到复验的过程；盘点结论和映射表则以文档形式留存，供切换前复核。ONES 的 Confluence 迁移方案支持将空间、页面、附件和权限结构迁移到 ONES Wiki，迁移数据包括用户、用户组、空间权限与页面权限，页面正文、附件、图片、常用宏及批注也在迁移范围内，批量迁移与数据包导入是可选方式。页面树层级的具体还原规则、宏类型范围和元数据迁移支持，需要在选型核验阶段向实施方逐项确认。

阻断项与完成条件

阻断项是未通过即不得进入正式迁移的检查项。典型阻断项包括：空间清单未确认，存在无迁移结论的空间；权限映射缺失，受限页面或账号存在未决项；大附件没有处置方案；试迁移差异未闭环。这些项目直接影响迁移范围和内容完整性，不能以“切换后再补”的方式处理。

每类阻断项要有解除条件和确认人。空间清单的解除条件是全部空间有结论并经迁移负责人签字；权限映射的解除条件是映射表无待确认项并经 IT/安全确认；大附件的解除条件是每个超限文件有执行中的处置方案；试迁移差异的解除条件是需修复项完成复验。确认人按角色分工确定，避免由同一人既执行又放行。

整体完成条件是：全部阻断项清零；非阻断项有登记、责任人和计划完成时间；清单版本和签字记录归档。满足这些条件后，迁移负责人可以签发正式迁移的放行结论，清单随之转入切换执行阶段的跟踪。

阻断项	解除条件	确认人
空间清单未确认	全部空间有迁移结论并签字	迁移负责人
权限映射缺失	受限页面与账号映射无未决项	IT/安全
大附件无处置方案	每个超限文件有处置方式和执行人	内容所有者
试迁移差异未闭环	需修复项完成复验	迁移负责人

常见问题

迁移前清单和交接模板可以合并成一张表吗？

建议分开维护。清单回答“这一项是否达到通过标准”，产出通过或不通过的结论和证据；交接模板回答“交接了什么内容”，记录空间负责人、内容范围、特殊约定和接收方。合并后容易出现记录很全但无人判断是否放行的情况。两者可以互相引用，但判断动作和记录动作分开，责任更清晰。

空间很多但活跃度差异大，盘点时要不要全部按同一深度核对？

不需要。空间清单要求每个空间都有迁移结论，但核对深度可以按迁移结论区分。确定迁移的空间需要完整核对页面树、附件、权限和字段映射；归档不迁移的空间只需记录归档结论和保留方式；废弃删除的空间确认清理范围即可。关键是每个空间的结论有负责人签字，而不是所有空间都做同等深度的盘点。

试迁移样本空间选几个合适，覆盖哪些页面类型？

样本数量不必多，重点是覆盖主要页面类型：普通页面、含附件的页面、含宏或嵌入内容的页面、受限页面、使用模板创建的页面，以及存在跨空间引用的页面。一个样本空间能同时覆盖其中几类即可。样本的作用是暴露结构、附件、链接和权限四类问题，如果试迁移后没有发现任何差异，反而需要检查样本覆盖度是否足够。

账号映射表里已离职账号和外部协作者怎么处理？

这两类账号在映射表中单独标记，不并入普通用户映射。已离职账号的常见处置是内容归属转给接替人、账号本身不迁移；外部协作者需要确认是否继续保留访问，涉及合规要求的由 IT/安全给出结论。每项处置要有确认人，正式切换前映射表中不允许存在待确认状态。

阻断项清零后，非阻断项还没完成，可以启动正式迁移吗？

可以启动，但非阻断项要有登记、责任人和计划完成时间，并在切换执行阶段继续跟踪。阻断项和非阻断项的区分标准是是否直接影响迁移范围或内容完整性：空间清单、权限映射、大附件处置、试迁移差异属于阻断项；数量统计口径、外部链接风险标注等属于非阻断项。放行结论由迁移负责人签发，签字记录和清单版本一并归档。