从 Confluence 迁出，风险不在“能不能导出”，而在导出之后能不能还原成团队可用的知识结构。需要逐项评估五类对象：内容资产、权限与身份、链接与集成、流程与协作习惯、迁移过程本身。评估结论应落到“可平移、需重建、可放弃”三张清单，并写明核验方式与停止条件。本文聚焦迁移准备阶段，盘点与核验记录可以放在 ONES 的文档和工作项中流转。
要点总览（TL;DR）
- 迁出 Confluence 的风险评估围绕五类对象展开：内容资产、权限与身份、链接与集成、流程与协作习惯、迁移过程本身，结论落到“可平移、需重建、可放弃”三张清单。
- 盘点要先固定来源版本与部署形态，按空间、附件、版本历史、宏与评论五个维度统计数量和抽样位置，放弃清单需内容所有者签字。
- 同名字段先定义口径再写转换规则；宏、嵌入内容、附件和评论无对应形态时按降级方案处理，聚合类宏由空间所有者重建。
- 试迁移抽样覆盖高风险内容类型，按内容完整性、格式还原度、链接可达性、权限可见性、搜索可检索性五项核验，通过标准在试迁移前写定。
- 出现系统性内容丢失、越权可见或核心空间大面积无法渲染时应暂停；正式切换前准备好源系统保留期、导出快照和页面 ID 对照表，并明确回退判定人。
迁出范围：先盘清 Confluence 里有什么
盘点的第一步是固定来源版本与部署形态。Confluence 云版与数据中心版在导出入口、导出包结构和附件处理上存在差异，同一套盘点模板在两个版本上得到的可用性结论可能不同。项目启动时应记录实例版本号、部署方式、当前存储占用，以及是否启用了外部目录或跨实例引用。这些信息决定了后续导出能力核验的对象，也决定了哪些空间需要单独处理。
盘点按五个维度展开，每个维度都要给出数量和抽样位置，避免只报总数：
- 空间与页面树：空间数量、页面总数、最大页面树深度、跨空间引用较多的空间。深层页面树往往是迁移后目录压缩和链接重写的高风险区。
- 附件与图片：附件总量、单文件最大体积、文件类型分布、被多页面引用的公共附件。公共附件在目标系统中可能变成重复副本，需要在盘点时标记。
- 版本历史：各空间保留的版本数量、是否存在必须保留的审计型页面。历史版本是否随导出保留，需要在导出能力核验中单独确认，不能默认跟随。
- 宏与嵌入内容：按宏类型统计使用次数，区分展示类宏、聚合类宏、外部嵌入类宏和自定义宏。聚合类与自定义宏通常需要重建或替换。
- 评论与批注：页面评论、行内批注的数量与分布，判断哪些讨论属于决策记录、需要随页面保留。
盘点结果按三类归档：必须迁移的内容（制度、产品文档、决策记录等仍在使用的页面）、可重建的内容（结构简单、可在目标系统重新搭建的模板页和索引页）、可归档放弃的内容（过期项目页、重复副本、无人维护的空间）。放弃清单需要内容所有者签字确认，避免迁移后出现“当时没人说要”的争议。目标系统尚未确定时，本阶段只做盘点与风险登记，不进入映射设计。
交付物是一张 Confluence 资产盘点表，字段至少包括：空间名称、页面数、附件量与体积、宏类型及次数、历史版本保留需求、分类结论（迁移/重建/放弃）、内容所有者。
迁移前的输入与依赖：哪些条件不齐就不能开工
盘点回答“有什么”，前置条件核对回答“能不能开始”。以下输入项缺少任何一项，都应标记为阻塞，而不是带着假设推进：
| 输入项 | 核验内容 | 责任人 | 未满足时的处理 |
|---|---|---|---|
| 内容导出能力 | 导出格式、附件是否随包导出、历史版本是否保留、单次导出体积上限 | IT/平台管理员 | 暂停映射设计，先做小范围导出验证 |
| 目标系统结构 | 目录层级规则、字段定义、权限模型、搜索索引方式 | 目标系统管理员 | 目标未定时只登记风险，不承诺映射方案 |
| 身份来源 | 本地账号、SSO 对接方式、外部协作者名单、离职账号处理 | IT/身份管理员 | 外部协作者无对应身份时，先定其内容归属 |
| 责任人分工 | 内容所有者、迁移执行人、业务验收人、回退判定人 | 项目经理 | 判定人未定则不设正式切换日期 |
| 源系统保留期 | 切换后 Confluence 只读保留时长、导出快照存放位置 | IT/平台管理员 | 保留期不足时推迟切换 |
身份对应关系需要单独核验。Confluence 中的用户组常常同时承担权限授予和通知分发两种作用，迁移到目标系统后，这两类用途可能由不同机制承接。盘点时应导出用户组清单，标注每个组的实际用途，并确认外部协作者在目标系统中以何种身份存在、能看到哪些空间。依赖未满足时的暂停判断要写进项目计划：导出能力未验证不进入映射，目标权限模型未确认不进入试迁移，回退判定人未指定不安排正式切换。
内容与字段映射：同名字段含义不同怎么处理
映射阶段的核心风险是“看起来对上了，实际含义不同”。处理原则是先定义口径，再写转换规则，最后才执行批量转换。页面层级映射到目标目录结构时，需要设定最大层级深度和压缩策略：超过目标系统建议深度的页面树，按主题合并中间层，保留原路径作为页面属性或标签，便于回溯。压缩规则要提前公示，避免迁移后用户找不到入口。
宏、嵌入内容、附件和评论在目标系统中没有对应形态时，按降级方案处理，而不是直接丢弃：
- 展示类宏：转为静态内容或目标系统支持的等价块，转换后人工抽查渲染效果。
- 聚合类宏（如页面列表、标签聚合）：在目标系统中用索引页或查询视图重建，重建责任落到空间所有者。
- 外部嵌入内容：保留原始链接并加注说明，或改为截图加链接，避免迁移后出现空白区块。
- 附件：随页面迁移，公共附件去重后保留一份并建立引用关系；无法迁移的格式列入问题登记表。
- 评论与批注：决策类评论随页面保留，讨论类评论可汇总为一个讨论记录页。
同名字段必须逐项定义口径。以“状态”为例，Confluence 页面标签中的状态可能表示文档成熟度，目标系统的状态字段可能表示工作流阶段，两者不能直接赋值。处理方式是建立字段映射表，每个字段写清源字段、目标字段、转换规则、冲突处理和责任人：
| 源对象 | 目标对象 | 转换规则 | 冲突处理 | 责任人 |
|---|---|---|---|---|
| 空间 | 知识库/目录 | 一个空间对应一个一级目录 | 空间过多时按业务线合并 | 平台管理员 |
| 页面标签“状态” | 文档属性“成熟度” | 按值映射表转换 | 无法映射的值置为“待确认” | 内容所有者 |
| 页面负责人 | 文档负责人字段 | 按账号对应关系转换 | 离职账号转给空间所有者 | IT/身份管理员 |
| 空间权限 | 目录权限 | 按用户组映射 | 继承关系不一致时改为显式授权 | 平台管理员 |
链接处理同样需要规则。页面互链在迁移后要按新旧页面 ID 对照表重写，外部链接保留原地址并做可达性抽检。断链检查应在试迁移后执行一次全量扫描，把断链按来源页面归类，交给对应内容所有者修复。权限映射的差异要单独说明：Confluence 的空间权限与页面限制继承关系，在目标系统中可能表现为目录权限加文档权限两层，继承被打破的页面需要显式授权，这类页面应在盘点表中提前标记。
试迁移与核验：用什么证据判断迁移可用
试迁移的目的不是证明“能迁”，而是找出哪类内容迁不好。抽样应覆盖高风险类型：含聚合宏或自定义宏的空间、附件密集的页面、层级最深的页面树、权限设置最复杂的空间、以及有外部协作者参与的空间。每个类型至少选一个代表性空间，样本量以能覆盖全部宏类型和权限形态为准。
核验按五个指标逐项打分，并记录证据位置：
- 内容完整性：页面数、附件数、评论数与盘点表比对，差异逐条说明原因。
- 格式还原度：表格、代码块、宏渲染、图片尺寸的还原情况，按页面抽查并截图留存。
- 链接可达性：互链重写后的跳转成功率，断链清单及修复状态。
- 权限可见性：用不同角色账号实际登录验证，确认无越权可见、无该看却看不到。
- 搜索可检索性：抽取关键词验证标题、正文、附件名能否被检索到。
通过标准在试迁移前就要写定，例如“抽样页面内容完整率 100%，宏渲染异常页面不超过抽样量的约定比例且均有降级方案，权限核验零越权”。不通过时记录问题类型、影响范围、处置结论（修复后重试、降级处理、放弃迁移），并指定复验人。证据留存包括迁移日志、源目标比对清单、权限核验记录和验收签字，这些材料在切换后出现争议时是唯一依据。试迁移的问题登记表应持续更新到正式切换，未关闭的高风险问题构成切换的阻塞项。
如果目标系统是 ONES Wiki，其 Confluence 数据迁移支持迁移页面正文、附件、图片、常用宏及批注，迁移数据包括用户、用户组、空间权限与页面权限，方式上支持批量迁移与数据包导入。这意味着盘点表中的宏类型、附件和权限结构可以直接对应到试迁移核验项；非常用宏和插件依赖的定制场景仍需逐项评估，不能假设一一对应。试迁移的问题登记、比对清单和验收记录可以放在 ONES 的工作项与文档中，按空间分派给内容所有者跟踪关闭。
回退与停止条件：什么情况下暂停或回退
停止条件要在试迁移阶段就生效，而不是等到正式切换才发现问题。出现以下情况应暂停迁移并复核：试迁移发现系统性内容丢失（同一类页面或附件批量缺失）、权限核验出现越权可见、核心空间的宏大面积无法渲染且无降级方案、身份对应关系存在无法解释的缺口。暂停由项目经理发起，判定人签字，复核结论写入问题登记表后才能恢复。
正式切换需要安排停机窗口与只读期。切换期间源系统设为只读，禁止新增编辑，窗口长度按导出、导入、核验三段估算并留出缓冲。回退的前置准备包括：源系统在切换后保留可读状态一段时间、切换前完成一次完整导出快照并验证可恢复、新旧页面 ID 对照表已生成。回退触发条件通常包括：核心空间内容缺失超过约定阈值、权限问题影响面扩大、目标系统在观察期内出现影响日常使用的故障。回退动作要写成可执行的步骤，并指定执行人和恢复验证方式。
| 触发条件 | 判定人 | 回退动作 | 恢复验证 |
|---|---|---|---|
| 试迁移出现系统性内容丢失 | 项目经理 + 内容所有者 | 暂停迁移，回到导出核验 | 重新抽样比对通过 |
| 权限核验发现越权可见 | 平台管理员 | 暂停切换，修正权限映射 | 多角色登录复验零越权 |
| 正式切换后核心空间不可用 | 回退判定人 | 恢复源系统读写，目标系统转只读 | 核心页面可访问、可编辑 |
| 观察期内检索或链接大面积失效 | 业务验收人 | 按预案修复或回退 | 抽检关键词与链接通过 |
切换后设观察期，核验项包括：日常高频页面的访问与编辑是否正常、搜索能否命中关键文档、权限是否随人员变动正确生效、旧链接跳转是否可用。观察期内的责任归属要明确到人：平台管理员负责系统层问题，内容所有者负责内容修复，业务验收人负责确认可用。观察期结束并完成验收签字，迁移才算关闭；此前所有“已完成”的表述都应附带未关闭问题清单。
常见问题
Confluence 云版和数据中心版迁出时，盘点方式要区别对待吗？
要区别对待。两个版本在导出入口、导出包结构和附件处理上存在差异，同一套盘点模板得到的可用性结论可能不同。项目启动时先记录实例版本号、部署方式、存储占用，以及是否启用外部目录或跨实例引用，再决定哪些空间单独处理。导出能力核验也应按实际部署形态做小范围验证，确认附件和历史版本是否随导出保留。
历史版本、页面模板、白板这类内容能一起迁走吗？
需要逐项核验，不能默认跟随。盘点阶段先把这些内容形态单独列出，标注保留需求和数量；导出能力核验时确认历史版本是否随导出保留。以 ONES Wiki 为目标的迁移场景，官方说明覆盖页面正文、附件、图片、常用宏及批注，其余形态需在迁移前逐项评估，无法确认的部分列入问题登记表，由内容所有者决定重建或放弃。
迁移过程中发现权限越权可见，应该怎么处理？
立即暂停切换，由平台管理员复核权限映射。常见原因是 Confluence 的空间权限与页面限制继承关系，在目标系统中变成目录权限加文档权限两层，继承被打破的页面需要显式授权。修正后要用不同角色账号实际登录复验，确认零越权、该看的内容都能看到，复验记录留档后才能恢复迁移。
正式切换后多久可以关闭迁移项目？
观察期结束并完成验收签字才算关闭。观察期内核验高频页面的访问与编辑、搜索能否命中关键文档、权限是否随人员变动正确生效、旧链接跳转是否可用，责任分到平台管理员、内容所有者和业务验收人。此前所有“已完成”的表述都应附带未关闭问题清单，未关闭的高风险问题构成项目关闭的阻塞项。
目标系统是 ONES Wiki 时，迁移方式和覆盖范围是什么？
ONES 的 Confluence 数据迁移支持批量迁移与数据包导入，迁移数据包括用户、用户组、空间权限与页面权限，内容侧覆盖页面正文、附件、图片、常用宏及批注。盘点表中的宏类型、附件和权限结构可以直接对应到试迁移核验项；非常用宏和插件依赖的定制场景仍需逐项评估，不能假设一一对应。具体导入包格式和操作细节建议向原厂确认。
