Confluence 迁移验收要回答的核心问题是：迁移后的知识库能否支撑团队正常使用，并且出问题时能及时退回。这份清单按“准备确认—内容迁移—权限与结构—协作与集成—切换与回退”五个阶段组织，每项检查都写明通过标准、证据、负责人和是否阻断。数据完整性、权限还原、关键页面可用性和回退方案属于阻断项，任一未通过就不进入正式切换。验收过程可以用工作项逐项分配、流转和留痕，ONES 的迁移方案覆盖空间、页面、附件和权限结构，可作为目标平台侧的准备参考。
要点总览（TL;DR）
- 验收按准备确认、内容迁移、权限与结构、协作与集成、切换与回退五个阶段推进，每个阶段都有明确的检查项和负责人。
- 数据完整性、权限还原、关键页面可用性和回退方案列为阻断项，任一未通过就暂停进入正式切换。
- 通过标准要写成可观察、可判定的表述，并配套截图、导出报表、抽样记录或签字确认作为证据。
- 未通过项记录问题、责任人和复检时点，复检通过后再更新结论；一般项可在观察期内闭环。
- 把检查项拆成工作项分配负责人和时点，用状态流转和证据附件留痕，汇总视图作为放行切换的判断依据。
谁在什么时点使用这份验收清单
验收清单由迁移项目负责人统一维护，但不同角色只负责自己熟悉的检查段。把职责提前分好，能避免正式迁移时出现“都以为对方查过”的遗漏。
| 角色 | 主要检查职责 | 参与时点 |
|---|---|---|
| 迁移项目负责人 | 维护清单版本，确认阻断项结论，决定是否放行切换 | 全程，重点在准备评审和切换放行 |
| 知识库管理员 | 范围盘点、内容抽样比对、空间结构与模板映射 | 准备阶段、试迁移、正式迁移后 |
| IT/运维 | 账号映射、权限还原验证、域名与入口切换、备份与回退演练 | 准备阶段、切换当日、观察期 |
| 业务部门代表 | 关键页面可用性、日常编辑评论分享、搜索命中验证 | 试迁移后、切换后观察期 |
检查时点分为四个：准备阶段在动手前完成范围、映射和预案确认；试迁移后做第一轮全量核对，暴露问题并修正方案；正式迁移后按同一口径复检；切换后观察期持续收集使用问题，确认无阻断级异常再结束项目。
阻断项与一般项的区分原则是：影响数据完整性、访问控制、关键业务页面可用性或无法回退的问题列为阻断项，未通过即暂停进入下一时点；影响体验但不妨碍使用的，如个别非关键页面样式偏差、通知延迟，列为一般项，记录问题、责任人和复检时点，可在观察期内修复。
迁移前准备阶段的检查项
准备阶段的目标是把“迁什么、迁给谁、怎么迁、出问题怎么办”四件事确认到可执行的程度。带着未决问题开始迁移，后面每个阶段都会返工。
| 检查项 | 通过标准 | 证据 | 负责人 | 是否阻断 |
|---|---|---|---|---|
| 源空间与内容范围盘点 | 列出全部待迁空间，记录页面数、附件数、历史版本数，形成数量基线 | 导出报表或盘点表 | 知识库管理员 | 是 |
| 账号与用户映射 | 源端用户、用户组与目标端账号一一对应，外部协作者有明确处理结论 | 映射表、确认邮件 | IT/运维 | 是 |
| 空间结构与模板映射 | 每个源空间对应目标空间，页面模板、字段、目录结构有对应方案 | 映射方案文档 | 知识库管理员 | 是 |
| 迁移窗口与冻结编辑 | 窗口时间、通知范围、冻结起止时间已发布并被相关团队确认 | 通知记录、确认回执 | 项目负责人 | 是 |
| 备份与回退预案 | 源端有完整备份，回退步骤、触发条件、执行人已书面确认 | 备份记录、回退预案 | IT/运维 | 是 |
| 特殊元素清单 | 宏、嵌入内容、状态标签、评论等逐项列出，并确认目标端的处理方式 | 特殊元素清单 | 知识库管理员 | 否 |
特殊元素这一项容易漏。Confluence 页面里常见的目录宏、状态标签、嵌入的表格或看板，迁移后表现可能不同，准备阶段先列清单，试迁移时才能逐项对照。ONES 的迁移方案支持页面正文、附件、图片、常用宏及批注，常用宏的具体范围需要在项目里逐项确认，未覆盖的宏要提前定好替代或手工处理方式。
内容与附件迁移的检查项
内容核对不能只看“迁移任务成功”，要按数量、抽样和特殊元素三层验证。建议试迁移和正式迁移各做一轮，用同一套抽样规则，便于对比。
| 检查项 | 通过标准 | 证据 | 负责人 | 是否阻断 |
|---|---|---|---|---|
| 页面数量与层级 | 目标端页面数与基线一致，空间树层级与源端对应 | 数量对比报表、层级截图 | 知识库管理员 | 是 |
| 标题与正文抽样 | 按空间分层抽样不少于 30 个页面，标题、正文一致率 100%，差异项有记录 | 抽样比对记录 | 知识库管理员 | 是 |
| 附件核对 | 附件数量与基线一致，文件名可辨认，抽样附件可正常下载打开 | 附件清单、下载测试记录 | 知识库管理员 | 是 |
| 历史版本与评论 | 按项目约定保留的版本和评论已迁移，抽样可查看 | 版本对比截图 | 知识库管理员 | 否 |
| 宏与嵌入内容 | 清单内每个特殊元素有明确结果：正常显示、已替换或已记录待处理 | 特殊元素核对表 | 知识库管理员 | 否 |
| 内链与跨空间链接 | 抽样页面的内链可跳转，跨空间链接指向正确目标 | 链接抽查记录 | 业务部门代表 | 是 |
抽样比对记录建议固定格式：源页面地址、目标页面地址、比对项（标题/正文/附件/链接）、结果、差异说明、处理人。历史版本和评论是否保留取决于项目约定，验收时按约定判定，不默认全部保留。链接检查要覆盖跨空间引用，这类链接在迁移后最容易指向失效地址。
权限、空间结构与协作功能的检查项
权限还原是迁移验收里最容易被低估的部分。页面迁过去了但看不了，等于没迁。这一阶段要同时验证“谁能看”和“能不能正常协作”。
| 检查项 | 通过标准 | 证据 | 负责人 | 是否阻断 |
|---|---|---|---|---|
| 空间级权限 | 每个空间的可见范围与源端一致，受限空间对非成员不可见 | 权限对比表、越权访问测试记录 | IT/运维 | 是 |
| 页面级权限 | 抽样受限页面仅授权用户可访问，继承关系正确 | 抽样测试记录 | IT/运维 | 是 |
| 用户组与角色 | 用户组成员与源端对应，角色权限符合映射方案 | 用户组对照表 | IT/运维 | 是 |
| 搜索命中 | 用关键页面标题和正文关键词搜索，前若干条结果包含目标页面 | 搜索截图 | 业务部门代表 | 是 |
| 协作动作 | 编辑、评论、@提及、分享链接在抽样页面均可正常完成 | 操作记录或截图 | 业务部门代表 | 否 |
| 通知与订阅 | 页面更新后订阅者能收到通知，@提及能触达被提及人 | 通知截图 | 业务部门代表 | 否 |
越权测试要专门做：用一个不在授权名单里的账号尝试访问受限空间和受限页面，确认被拒绝。ONES 的 Confluence 数据迁移包括用户、用户组、空间权限与页面权限，迁移后仍需按上述口径实测，不能只依赖迁移报告。协作动作的验证建议由业务部门代表在真实工作场景中完成，比如编辑一篇正在维护的文档、在页面上发起一次讨论。
集成、切换与回退的检查项
切换阶段的风险集中在外部依赖和回退能力上。检查顺序建议先验证集成，再执行切换，最后进入观察期。
| 检查项 | 通过标准 | 证据 | 负责人 | 是否阻断 |
|---|---|---|---|---|
| 外部系统链接 | 代码仓库、工单、CI 等系统中指向知识库的链接可打开正确页面 | 链接测试记录 | IT/运维 | 是 |
| 入口与旧链接跳转 | 域名、书签、旧链接按方案跳转，抽样旧链接可达 | 跳转测试记录 | IT/运维 | 是 |
| 切换操作顺序 | 切换当日步骤、时间点、责任人已书面排定并演练 | 切换操作手册 | 项目负责人 | 是 |
| 回退触发条件 | 明确何种情况触发回退，判定人和执行人已确认 | 回退预案 | 项目负责人 | 是 |
| 回退步骤与验证 | 回退步骤可执行，回退后源端可正常访问，验证方式明确 | 回退演练记录 | IT/运维 | 是 |
| 观察期监控 | 问题收集渠道、响应人、观察期时长已确定并通知 | 通知记录 | 项目负责人 | 否 |
回退演练建议在正式切换前做一次，哪怕只演练关键步骤。触发条件要写成可判断的情形，例如“关键空间超过约定比例页面无法访问且短时间内无法修复”，避免“情况严重时回退”这类无法执行的表述。原来依赖 Confluence 插件的功能，需要在切换前完成梳理和替代确认，ONES 建议先梳理实际使用的插件，再通过 Project、Wiki、TestCase、流程自动化和开放能力做功能匹配，定制场景逐项评估，不假设所有插件都能一一对应。
通过标准、证据与阻断项汇总
各阶段检查项最终要收敛到一张总表，项目负责人依据总表判断是否放行。通过标准的写法决定这张表能不能用。
可观察、可判定的通过标准通常包含对象、动作和阈值，例如“抽样 30 个页面，标题、层级、正文一致率 100%”“受限空间用非授权账号访问返回拒绝”。避免“基本正常”“大致一致”这类无法判定的描述，否则复检时无法得出相同结论。
| 证据类型 | 适用检查项 | 留存要求 |
|---|---|---|
| 截图 | 权限测试、搜索命中、协作操作、链接跳转 | 标注时间、操作账号、页面地址 |
| 导出报表 | 页面与附件数量、用户组对照 | 保留导出时间和来源 |
| 抽样比对记录 | 标题正文比对、附件下载、特殊元素 | 逐条记录结果与差异处理 |
| 签字确认 | 切换操作手册、回退预案、放行结论 | 确认人与日期 |
阻断项清单至少覆盖四类：数据完整性，页面和附件数量与抽样一致；权限还原，空间与页面权限和源端一致且越权测试通过；关键页面可用，业务指定的核心页面可访问、可搜索、可编辑；回退方案就绪，触发条件、步骤和演练记录齐全。任一阻断项未通过，不进入正式切换。
未通过项的处置流程是：记录问题描述、影响范围、责任人和复检时点，修复后按原通过标准复检，复检通过再更新结论。同一检查项多次复检时保留历史记录，便于追溯问题是否反复出现。一般项可在观察期内闭环，阻断项必须闭环后才能放行。
用工作项承载验收过程
清单写在文档里容易变成静态表格，落到工作项上才能跟踪到人、到时间、到结论。做法是把每个检查项拆成一个工作项，带上阶段、负责人、检查时点和是否阻断四个字段。
状态流转建议设为“待检查—检查中—通过/驳回—复检中—通过”。驳回时填写问题描述和复检时点，复检通过后关闭。证据以附件形式关联到对应工作项，验收结论写在结论文档或工作项结果字段里，保证每个结论都能找到对应证据。
项目负责人需要一个汇总视图：按阶段统计通过率、列出未关闭的阻断项、显示各负责人待办。放行切换的判断依据就是这个视图，而不是口头汇报。ONES 的迁移方案把数据完整、业务连续和系统稳定作为迁移目标，并建议把迁移工具、原厂服务和分阶段切换结合起来，在正式迁移前确认数据范围、功能匹配和系统适配；验收工作项的状态和证据留痕，正好为这些确认提供可查记录。具体工作项字段和视图配置需结合团队实际流程确定。
常见问题
试迁移已经通过，正式迁移后还需要按同一口径再查一遍吗？
需要。试迁移的作用是暴露问题和修正方案，正式迁移后数据范围、时间点和参与人员都可能变化，应按同一套检查项和抽样规则复检。复检时重点看试迁移中出现的差异项是否已修复，以及正式迁移是否引入新的数量偏差或链接失效。两次记录放在一起对比，能更快判断问题是偶发还是方案本身有缺口。
历史版本和评论没有全部迁移，验收能通过吗？
取决于项目约定。验收时按准备阶段确认的保留范围判定，不默认全部保留。如果约定只保留最近若干版本或关键页面的评论，就按这个范围核对抽样结果；如果约定全部保留而实际缺失，应作为差异项记录并明确处理方式。涉及关键业务页面且影响追溯的缺失，建议按阻断项处理。
回退演练要做到什么程度才算通过？
至少覆盖关键步骤：确认源端备份可用、按预案执行回退、回退后源端页面可正常访问、验证方式可复现。演练不必完整模拟所有场景，但触发条件、判定人和执行人要在演练中实际走一遍。演练记录作为证据留存，正式切换前据此确认回退方案就绪。
原来 Confluence 里用到的插件和宏，验收时怎么判定？
先在准备阶段梳理实际使用的插件和宏，逐项确认目标端的处理方式：正常显示、已替换或记录待处理。验收时按这份清单核对，每个特殊元素都要有明确结果。ONES 建议先梳理实际使用的插件，再通过 Project、Wiki、TestCase、流程自动化和开放能力做功能匹配，定制场景逐项评估，不假设所有插件都能一一对应。常用宏的具体范围需在项目中确认。
观察期内发现的问题，什么情况下要重新触发回退？
按切换前约定的触发条件判断，例如关键空间超过约定比例页面无法访问且短时间内无法修复。观察期内出现这类情形，由判定人确认后执行回退，并按预案验证源端可用。一般体验问题记录后由责任人跟进，在观察期内闭环，不触发回退。
