Confluence 迁移验收清单的价值，在于把“迁完了”变成可以逐项判断通过与否的证据。清单应覆盖迁移前准备、试迁移、正式切换前和切换后观察期，围绕迁得全、迁得对、迁得可用、迁得可回退四类目标设置检查项，每项写明检查对象、通过标准、证据形式、负责人和检查时点，并标出影响上线的阻断项。本文给出一份可直接套用的分阶段检查表。
要点总览（TL;DR）
- 清单按迁移前准备、试迁移、正式切换前、切换后观察期四个时点组织，每个时点对应不同的检查重点和负责人。
- 检查项围绕迁得全、迁得对、迁得可用、迁得可回退四类目标设置，数量比对以迁移前建立的基线为参照。
- 每项检查写明检查对象、通过标准、证据形式、负责人和检查时点，通过标准使用可判定的表述，证据按阶段-检查项-空间-日期归档。
- 阻断项需全部关闭才能上线，一般项允许带问题上线但须登记责任人与修复期限，上线签字由迁移负责人、知识库管理员和IT/安全审核人共同确认。
- 权限验收采用映射表比对加抽查账号实测两步，搜索验收需覆盖附件，切换后观察期安排一次复查。
谁在什么时点使用这份验收清单
这份清单面向 Confluence 空间与页面迁移到目标知识平台的验收过程，不涉及目标平台选型。不同角色在迁移的不同阶段使用清单的不同部分，先明确分工，后续检查项才有责任归属。
| 角色 | 主要职责 | 使用清单的时点 |
|---|---|---|
| 迁移负责人 | 统筹计划、组织试迁移、汇总问题、发起上线签字 | 全阶段 |
| 知识库管理员 | 确认空间与页面基线、核对附件与链接、执行抽样比对 | 迁移前准备、试迁移后、切换后观察期 |
| 空间负责人 | 确认本空间内容范围、权限映射、特殊页面登记，参与可用性抽查 | 迁移前准备、试迁移后、正式切换前 |
| IT/安全审核人 | 审核账号映射、敏感空间权限、回退方案与安全合规要求 | 迁移前准备、正式切换前 |
检查时点建议划分为四段：迁移前准备阶段确认输入与基线；试迁移后核对数据一致性；正式切换前确认阻断项清零并完成签字；切换后观察期复查权限、搜索与协作的实际使用情况。范围边界上，清单只覆盖迁移本身的验收，目标平台的选型对比、授权谈判另行处理。
迁移前准备阶段检查项
准备阶段的目标是把验收基准定下来。没有基线，后续的“数量一致”就无从判断。以下检查项应在迁移执行前全部确认，并由对应负责人留存证据。
| 检查项 | 通过标准 | 证据形式 | 负责人 |
|---|---|---|---|
| 空间清单与页面数量基线 | 待迁移空间清单经空间负责人逐项确认，每个空间的页面数已导出并留存 | 空间清单表、页面数导出报表 | 知识库管理员 |
| 附件总量与大小上限 | 附件总数、总容量、单文件最大体积已统计，超出目标平台上限的文件已列出处理方案 | 附件统计报表、超限文件清单 | 知识库管理员 |
| 用户与用户组映射表 | 源端用户、用户组与目标端账号逐一对应，无遗漏账号，离职或停用账号已标注 | 账号映射表 | IT/安全审核人 |
| 页面权限与继承关系 | 各空间权限结构已梳理，受限页面清单与继承关系已记录 | 权限梳理表 | 空间负责人 |
| 宏、插件与嵌入内容 | 使用宏、插件、外部嵌入的页面已逐页登记，并标注目标平台的对应处理方式 | 特殊页面登记表 | 知识库管理员 |
| 迁移窗口与回退窗口 | 迁移起止时间、回退决策时间点、通知范围已书面确认 | 迁移计划文档、通知记录 | 迁移负责人 |
特殊页面登记需要特别认真。Confluence 中依赖宏和插件的页面往往承载了目录、状态、任务列表等结构化信息，迁移前逐项登记并确认目标平台的对应能力，可以避免验收时才发现内容缺失却无法追溯原因。若目标平台是 ONES Wiki，其 Confluence 迁移支持页面正文、附件、图片、常用宏及批注，迁移数据还包括用户、用户组、空间权限与页面权限；“常用宏”的具体覆盖范围建议在准备阶段就与原厂逐项核对，未覆盖的宏页面列入特殊页面登记表单独跟踪。
试迁移与数据一致性检查项
试迁移是正式切换前最重要的证据来源。这一阶段的检查以基线为参照，用数量和抽样两种方式判断内容是否迁得全、迁得对。
| 检查项 | 通过标准 | 证据形式 | 负责人 |
|---|---|---|---|
| 空间数与页面数 | 与准备阶段基线逐空间比对，数量一致；差异项已逐条说明原因 | 比对报表 | 知识库管理员 |
| 附件完整性 | 附件数量一致，文件名无异常字符，按抽样比例下载打开均正常 | 附件比对记录、抽查截图 | 知识库管理员 |
| 页面层级与父子关系 | 抽查空间的页面树与源端一致，无页面挂错父级或丢失层级 | 页面树截图对照 | 空间负责人 |
| 版本历史保留范围 | 按迁移前约定的保留范围核对，约定保留的版本可查看 | 版本记录截图 | 知识库管理员 |
| 正文抽样比对 | 按内容类型分层抽样，抽样页面正文与源端逐段一致 | 抽样比对记录 | 知识库管理员 |
| 常见内容类型呈现 | 表格、代码块、图片在抽样页面中显示正常，无错位、乱码或图片丢失 | 页面截图 | 空间负责人 |
| 链接改写结果 | 内部链接、跨空间链接指向正确页面，外部链接保持原地址可访问 | 链接检查记录 | 知识库管理员 |
抽样方法建议在试迁移前就定好：按正文、表格、代码块、图片、宏页面等内容类型分层，每类抽取固定比例或固定数量，抽样页面覆盖不同空间和不同权限层级。抽样比例和判定口径写进迁移计划，验收时直接执行，避免临时定标准导致争议。版本历史的保留范围同样需要在迁移前与实施方确认，来源资料未给出统一口径时，以双方书面约定为准。
权限、搜索与协作可用性检查项
数据数量对得上，不代表知识库可用。这一阶段从真实使用场景出发，检查权限是否越权或收窄、内容能否被找到、协作动作是否正常。
| 检查项 | 通过标准 | 证据形式 | 负责人 |
|---|---|---|---|
| 空间与页面权限映射 | 权限映射表与迁移后实际配置逐项一致 | 权限对照表 | IT/安全审核人 |
| 敏感空间访问抽查 | 用无权限账号实测无法访问，用授权账号实测可正常访问，无越权 | 抽查账号访问截图 | IT/安全审核人 |
| 搜索结果命中 | 用页面标题、正文关键词、附件名分别搜索，抽样页面与附件均能命中 | 搜索测试记录 | 知识库管理员 |
| 协作动作可用 | 抽样页面可正常编辑、评论、@提及，通知能送达被提及人 | 操作截图、通知记录 | 空间负责人 |
| 导航与目录结构 | 按原使用习惯可在三次点击内找到抽样页面 | 查找路径记录 | 空间负责人 |
权限验收建议采用两步法：先比对映射表，确认配置层面一致；再用不同权限的测试账号实际访问，确认效果层面一致。两步都通过才算该项完成。搜索验收要覆盖附件，很多团队迁移后才发现附件搜不到，影响日常查找。搜索索引的生效时间若无法提前确认，应在切换后观察期安排复查。
每项检查的通过标准与证据形式
清单要能用于判断，关键在于通过标准写成可判定的表述。以下写法可以直接套用：数量类写成“与基线一致，差异项已逐条说明”；抽样类写成“抽样 N 个页面全部通过，无未解释差异”；权限类写成“抽查账号访问结果与映射表一致，无越权”；功能类写成“指定操作可完成，结果符合预期”。避免“基本正常”“大致一致”这类无法判定的描述。
证据形式按检查类型固定：数量比对留存导出报表或比对记录；页面呈现留存截图；权限抽查留存账号访问截图并注明账号与页面；抽样比对留存逐页比对记录并由检查人签字。证据文件统一命名，建议采用“阶段-检查项-空间-日期”的格式，归档到迁移项目的统一位置，便于上线评审时调取。
不通过时记录以下字段：问题描述、影响的空间与页面范围、发现时点、责任人、修复期限、复检结果。问题登记后进入跟踪，复检通过才关闭。检查项跟踪、问题登记与签字确认可以放在项目协作工具中承载，便于留存证据和追溯责任人；具体用哪个工具按团队现有条件决定。若团队使用 ONES，迁移验收的检查项、问题单和签字记录可以在同一项目内流转，与迁移任务共用一套工作项。
阻断项与完成条件
并非所有问题都值得推迟上线。验收清单需要在上线前就明确阻断项口径，避免切换当天临时争论。阻断项指不解决就不能上线的问题，典型包括：核心空间缺失或页面数量与基线存在未解释的大幅差异；权限抽查发现越权访问；附件大面积不可下载；关键页面无法编辑或正文严重错乱；回退方案未就绪。
一般项指影响体验但不影响基本使用的问题，例如个别页面格式轻微错位、非核心空间的目录层级偏差、少量外部链接失效。一般项允许带问题上线，但必须有责任人和修复期限，并在观察期内复检关闭。
| 类别 | 判定口径 | 上线处理 |
|---|---|---|
| 阻断项 | 影响核心内容完整性、权限安全、基本可用性或回退能力 | 全部关闭后方可上线 |
| 一般项 | 不影响基本使用，可在上线后修复 | 登记责任人与期限，观察期复检 |
整体完成条件建议写成三条：阻断项全部关闭并有复检记录；一般项全部登记且责任人与期限明确；上线签字由迁移负责人、知识库管理员和 IT/安全审核人共同确认。切换后观察期建议安排一次复查，重点核对权限抽查、搜索命中和协作动作，确认上线后实际使用与验收结论一致，复查结果作为项目收尾的依据。
常见问题
试迁移抽样比例定多少合适，抽样结果出现差异时怎么处理？
抽样比例没有统一标准，建议按内容类型分层后每类抽取固定数量或固定比例，并保证抽样页面覆盖不同空间和不同权限层级。比例和判定口径在试迁移前写进迁移计划，验收时直接执行。
出现差异时先判断差异性质：数量类差异逐条说明原因，属于迁移遗漏的进入问题登记；呈现类差异（格式错位、图片丢失）记录页面地址和截图；链接类差异区分内部链接改写错误和外部链接本身失效。所有差异登记后由责任人修复并复检，复检通过才关闭该项。
Confluence 中的宏和插件页面在验收时怎么判定通过？
宏和插件页面无法用统一标准判定，需要在迁移前逐页登记并约定处理方式。登记表至少包含页面地址、使用的宏或插件、承载的信息类型、目标平台的对应处理方式。
验收时按登记表逐项核对：有对应能力的，检查迁移后页面显示和交互是否正常；无对应能力的，确认已按约定改为静态内容、手工重建或列入后续处理清单。ONES 的 Confluence 迁移支持页面正文、附件、图片、常用宏及批注，“常用宏”的具体覆盖范围建议在准备阶段与原厂逐项核对，未覆盖的宏页面单独跟踪。
版本历史和页面评论不在迁移范围内，验收清单还要检查吗？
要检查，但检查的是“是否符合约定”而不是“是否全部迁过来”。版本历史、评论、附件版本的保留范围需要在迁移前与实施方书面确认，验收时按约定范围核对：约定保留的版本可查看，约定不迁移的内容在清单中标注为不适用，避免验收时把范围外内容当成缺失。
ONES 的 Confluence 数据迁移支持迁移页面正文、附件、图片、常用宏及批注，版本历史等细粒度数据的保留范围来源未给出统一口径，以双方书面约定为准。
切换后发现权限越权或搜索不到内容，还能回退吗？
能否回退取决于迁移前确定的回退窗口和回退方案，这也是清单把“回退方案未就绪”列为阻断项的原因。切换后观察期发现权限越权，属于影响权限安全的问题，应立即按预案处理：先收紧相关空间权限，再评估是局部修复还是整体回退。
搜索不到内容先区分是索引未生效还是内容未迁入，前者安排索引重建后复查，后者回到数据一致性检查项追溯。观察期复查结果应记录在案，作为项目收尾依据。
团队规模不大，验收清单可以简化吗？
可以简化检查项数量，不建议省略通过标准和证据形式。小规模迁移可以把空间清单、页面数基线、附件抽查、权限抽查、关键页面可用性这几项保留为核心，抽样数量按实际页面数调整。
阻断项口径仍需在上线前明确，上线签字至少由迁移负责人和知识库管理员确认。检查项和问题登记可以放在团队现有的项目协作工具中跟踪，便于留存证据和追溯责任人。
