Confluence页面迁移完成后，附件、链接和权限是三类最容易出现偏差的对象。核对时建议按“附件→链接→权限”的顺序推进：先按页面清单确认附件是否完整到达目标端，再逐类检查页面内链接是否指向正确对象，最后用源端与目标端的权限对照表验证可见范围。整个过程以清单全量比对配合关键页面抽查为主，发现差异先记录再决定修复或回退，不默认迁移工具会完整保留链接与权限。
要点总览（TL;DR）
- 核对按“附件→链接→权限”的顺序推进：附件缺失会连带造成附件链接失效，先修附件再查链接可以减少重复工作。
- 附件核对以页面维度的清单比对为主，逐页比对文件名、数量、大小和版本数，再对关键页面实际打开引用位置抽查可用性。
- 链接按附件链接、页面互链、外部链接、锚点链接、宏生成链接分类建立清单，逐类检查，宏生成内容必须打开页面看渲染结果。
- 权限核对把空间级权限与页面级限制分开记录，受限页面用应可见、应不可见和管理员三类账号实际访问验证，附件权限单独确认。
- 差异先记录再处置：链接重写、附件补传可批量修复；权限放大、版本丢失需人工确认；核心页面附件大面积缺失或权限放大无法收窄时触发回退。
迁移范围：哪些页面、附件和权限需要核对
核对工作的第一步是把“迁移了什么”写清楚。源空间与目标空间的对应关系应逐条列出，例如源端三个产品空间分别迁入目标端哪几个知识库，一对一、多对一还是合并迁移，都要在清单中固定下来。对应关系不清，后续附件和链接的比对就失去基准。
页面范围要覆盖层级结构。除顶层页面外，子页面、孙页面以及通过页面树挂载的深层内容都应计入总数，并标注每棵页面树的根页面，便于按树核对而非按散页核对。附件口径需要同时记录类型和数量：图片、文档、表格、压缩包分别计数，同名附件和多版本附件单独标记，避免只比总数掩盖结构差异。
受限页面要提前识别。逐页查看页面限制（谁可以查看、谁可以编辑），并区分“页面自身设置了限制”和“仅继承空间权限”两种情况，前者是权限核对的重点样本。归档空间、个人空间、草稿以及明确不迁出的历史页面，应在范围清单中列为排除项并注明原因，防止核对阶段被误判为缺失。
完成本节后应产出一份迁移核对范围清单，至少包含：源空间与目标空间对应表、页面总数与页面树清单、附件类型与数量、受限页面数量及清单、排除项说明。这份清单是后续三张核对表的共同底稿。
核对前的输入与依赖准备
核对能否顺利执行，取决于源端清单、目标端访问条件和检查方式是否提前备齐。建议在迁移执行前就从源端导出页面树和附件清单，迁移后再导出一次目标端清单，两份数据在同一张表里比对。
- 源端导出清单：页面树结构、页面标题与页面ID、附件清单（文件名、大小、版本数、所属页面）、页面限制列表。Confluence可通过空间导出或管理接口获取，导出时记录导出时间点。
- 权限清单：空间权限（用户组与权限项）、页面限制（受限用户与用户组）、用户与用户组的对应关系。跨系统迁移时用户账号往往需要映射，映射表要在核对前确认。
- 目标端账号：至少准备一个管理员账号用于查看全部配置，以及若干只读核对账号，分别属于不同用户组，用于实际访问验证。
- 链接检查方式：页面量小时可人工抽查，页面量大时用脚本抓取页面正文中的链接地址批量比对。两种方式都要事先约定抽查比例和判定口径。
缺项时的处理方式也要写进准备清单：源端无法导出附件版本信息的，改为逐页人工记录；目标端暂时没有只读账号的，先用管理员账号完成配置核对，访问验证延后补做并标注。准备阶段结束时形成核对输入清单与责任分工表，明确谁提供清单、谁执行比对、谁做访问验证、谁负责复核。
附件核对：从清单比对到逐页抽查
附件核对分两层：先做数量与文件名的清单比对，再做内容可用性抽查。第一层按页面维度展开，逐页比对源端与目标端的附件数量、文件名、大小和版本数，任何一项不一致都记入差异。第二层针对关键页面，实际打开页面中引用附件的位置，确认附件能下载、能预览、内容与源端一致。
大小与版本数差异要区别对待。大小完全一致通常说明文件完整；大小不同可能是传输截断，也可能是源端本身存在多个版本而目标端只保留了最新版。版本数减少属于结构性差异，需要人工确认是否可接受，不能简单按“缺失”处理。同名附件要结合所属页面和上传时间判定，避免把两个不同页面的同名文件误判为重复或丢失。
附件在页面中的引用位置同样要检查。附件清单显示文件已到达，不代表页面正文里的引用仍然有效，尤其是以附件形式插入的图片和文档卡片，需要在页面上实际点击验证。发现缺失或损坏时，按统一格式记录，便于后续批量补传。
| 页面 | 附件名 | 源端状态（大小/版本数） | 目标端状态（大小/版本数） | 页面内引用是否可打开 | 结论 |
|---|---|---|---|---|---|
| 示例：产品需求说明 | 接口文档v2.docx | 2.1MB / 3版 | 2.1MB / 1版 | 可打开 | 版本减少，待确认 |
| 示例：部署手册 | 架构图.png | 480KB / 1版 | 未找到 | 无法打开 | 缺失，需补传 |
表格中的示例为演示情景，实际核对时按真实数据填写。全部页面比对完成后，统计附件核对覆盖率，作为后续通过判定的依据之一。
链接核对：分类检查页面内各类链接
页面内链接混在一起检查容易漏判，按类型拆分后逐类建立清单更可靠。常见类型包括附件链接、页面互链、外部链接、锚点链接，以及宏或嵌入内容生成的链接。每一类都有不同的失效原因和检查方法。
| 链接类型 | 检查方法 | 常见失效原因 |
|---|---|---|
| 附件链接 | 在页面中点击附件引用，确认下载或预览的是迁移后的附件 | 附件未迁到或引用仍指向源端地址 |
| 页面互链 | 逐条打开页面内指向其他页面的链接，确认落到目标端对应页面 | 页面标题变更、层级调整导致目标页面找不到 |
| 外部链接 | 抽查访问，确认地址未被改写且可正常打开 | 迁移过程误改URL，或源端链接本身已失效 |
| 锚点链接 | 点击后确认跳转到页面内对应标题位置 | 标题层级或锚点标识在转换中丢失 |
| 宏或嵌入内容生成的链接 | 打开含宏的页面，检查宏渲染结果中的链接与嵌入内容 | 宏未被支持或转换后生成指向源端的地址 |
宏生成链接需要单独说明。依赖宏或插件生成内容的页面，迁移前应逐项评估，避免假设所有插件都能一一对应；迁移后要实际打开页面查看渲染结果，确认嵌入的页面列表、目录、附件展示等是否正常。外部链接和锚点链接的检查成本较低，可全量抽查；页面互链数量大时，优先检查被高频引用的枢纽页面。
失效链接按影响排序处理：指向缺失附件的链接，随附件补传一并修复；页面互链错误，优先修正被多个页面引用的目标；外部链接失效若源端已失效，记录后不纳入本次修复范围。每条链接按“链接类型、所在页面、原地址、目标地址、状态、处理动作”登记，形成链接核对清单。
权限核对：页面限制与空间权限的对照验证
权限核对的核心是分开验证空间级权限和页面级限制。空间级权限决定谁能进入目标空间，页面级限制决定谁能看到某个受限页面，两者混在一起看，容易把“空间权限正确”误当成“页面限制也正确”。建议为每个受限页面建立一行对照记录，逐页比对源端与目标端的可见范围。
用户与用户组的映射要先确认。跨系统迁移时账号体系可能不同，源端的用户组在目标端对应哪个组、个别用户是否被合并或停用，都会影响可见范围的实际效果。映射关系确认后，再比对权限配置才有意义。
受限页面要用不同角色账号实际访问验证，只看配置列表不够。至少覆盖三类账号：应可见的用户、应不可见的用户、管理员。用应可见账号打开页面确认能访问，用应不可见账号确认被拦截，两者都符合预期才算通过。附件权限是否随页面继承，需要在目标端实际验证：用受限页面的可见账号尝试打开该页面的附件，确认附件访问范围与页面一致；若目标端存在独立于页面的附件权限设置，单独记录并纳入对照表。
| 页面 | 源端可见范围 | 目标端可见范围 | 实际访问验证结果 | 差异类型 | 处理 |
|---|---|---|---|---|---|
| 示例：薪酬方案 | 仅HR组 | HR组+研发组 | 研发账号可访问 | 权限放大 | 收窄后复验 |
| 示例：季度规划 | 管理层+产品组 | 仅管理层 | 产品账号被拦截 | 权限收窄 | 人工确认后调整 |
权限放大和收窄都要记录。放大意味着信息暴露风险，应优先处理；收窄意味着部分用户失去原有访问能力，需要业务方确认是否接受。所有差异写入权限对照表，作为修复和回退决策的输入。
在目标端承载页面、附件和权限时，ONES Wiki 的 Confluence 迁移方案支持将空间、页面、附件和权限结构迁入，迁移数据包括用户、用户组、空间权限与页面权限，页面正文、附件、图片、常用宏及批注也在迁移范围内，并提供批量迁移与数据包导入两种方式。核对阶段可以借助目标端的空间与页面权限配置逐页比对可见范围；附件链接是否自动重写、附件权限的继承规则等细节，仍需在迁移前测试中确认，并以实际迁移结果为准。
核验证据与通过标准
核对结果要能被复核，证据形式需要事先约定。附件核对表、链接核对清单、权限对照表是三类基础记录，配合关键页面的访问截图和脚本扫描日志，构成完整的核验证据。截图应包含页面地址、访问账号和访问结果，便于复核人独立判断。
覆盖率和样本量建议按以下口径执行：附件核对覆盖全部迁移页面，关键页面（被高频引用、含多版本附件、含宏嵌入内容）逐页打开验证；链接核对中附件链接和页面互链全量比对，外部链接和锚点链接按约定比例抽查；权限核对覆盖全部受限页面，每页至少用应可见和应不可见两类账号验证，管理员账号抽查若干页确认配置。
判定标准分三档：附件、链接、权限三类核对全部完成且差异均已记录并处置，判为通过；存在已记录但尚未处置的差异，且不影响核心业务页面使用，判为有条件通过，需明确处置时限；存在附件缺失、关键页面互链错误或权限放大未收窄的情况，判为不通过，进入修复或回退流程。复核人应在核对完成后独立抽查一定比例的记录，确认结论与证据一致，并在核验结论单上签署确认时点。
差异修复、回退与停止条件
发现差异后先记录再处置，按可批量修复和需人工确认两类分流。链接重写、附件补传属于可批量修复的差异，集中处理后重新跑一遍对应核对项即可闭环。权限收窄、版本丢失、宏渲染异常属于需人工确认的差异，由业务方判断是否接受，接受则记录为已知差异，不接受则进入修复。
触发回退的条件应提前写清楚，常见情形包括：核心业务页面附件大面积缺失且无法在切换窗口内补齐；受限页面出现权限放大且无法快速收窄；关键页面互链大面积失效导致导航不可用。回退时保留源端Confluence的只读访问作为过渡，目标端暂停写入，待差异修复并复验通过后再恢复切换。
停止迁移并重新评估的信号包括：差异集中在某一类对象上反复出现，说明迁移配置存在系统性问题；权限模型与源端差异过大，逐页调整成本超出预期；宏或插件生成内容大量无法对应。出现这些信号时，应暂停后续批次迁移，重新确认迁移范围、功能匹配和系统适配，再决定继续、调整方案或改用其他迁移路径。所有处置决定记入差异处置与回退决策记录，与核验结论单一并归档。
常见问题
迁移页面数量很大时，附件和链接核对能否只做抽样？
可以分层处理，但抽样范围要事先约定并写入核验结论单。附件核对建议全量比对文件名、数量、大小和版本数，这类比对可以借助导出清单批量完成，成本较低；内容可用性抽查则聚焦关键页面，例如被高频引用、含多版本附件或含宏嵌入内容的页面。链接核对中，附件链接和页面互链建议全量比对，外部链接和锚点链接可按约定比例抽查。权限核对不建议抽样，受限页面应逐页验证，因为权限放大属于信息暴露风险，漏检代价高。
附件数量一致但页面里的附件打不开，问题通常出在哪？
附件清单一致说明文件本身已到达目标端，打不开通常出在引用环节。常见原因有三类：页面正文中的附件引用仍指向源端地址，迁移后源地址不可访问；附件以宏或嵌入卡片形式展示，宏未被支持或转换后渲染异常；附件存在但目标端的预览或下载配置与源端不同。排查时先在目标端附件列表中直接打开文件，确认文件本身可用，再回到页面点击引用位置对比。若文件可用而引用失效，按链接问题处理，登记到链接核对清单，与附件补传分开修复。
受限页面迁移后，用管理员账号看得到就算权限正确吗？
不算。管理员账号通常拥有全量访问权限，用它验证只能确认页面存在，无法判断可见范围是否符合预期。受限页面至少要用两类账号实际访问：应可见的用户账号打开页面确认能访问，应不可见的用户账号确认被拦截。两类结果都符合预期，才说明页面限制落地正确。附件权限还要单独验证：用受限页面的可见账号尝试打开该页附件，确认附件访问范围与页面一致；若目标端存在独立于页面的附件权限设置，需单独记录并纳入对照表。
迁移后发现权限被放大，应该先修复还是先暂停切换？
权限放大意味着原本受限的内容可能被更多用户看到，应优先处置。建议先暂停目标端的对外使用，把受影响的受限页面清单整理出来，逐页收窄可见范围，再用应不可见账号复验，确认拦截生效后再恢复使用。如果权限放大集中在大量页面上、无法在切换窗口内逐页收窄，应视为触发回退的条件，保留源端只读访问作为过渡，待权限模型重新梳理后再继续。所有收窄操作和复验结果记入权限对照表，与核验结论单一并归档。
宏生成的链接和嵌入内容，迁移后怎么验证才算通过？
宏生成的内容无法只靠清单比对判断，必须打开页面查看实际渲染结果。验证时逐项确认：宏是否正常渲染、嵌入的页面列表或目录是否指向目标端页面、宏内生成的链接点击后是否落到正确对象。依赖宏或插件生成内容的页面，迁移前应逐项评估，避免假设所有插件都能一一对应；迁移后发现的异常按页面记录，能通过调整宏配置修复的归入批量修复，无法对应的由业务方确认是否接受简化展示。ONES 的 Confluence 迁移方案支持迁移常用宏，具体宏的覆盖范围需在迁移前逐项确认。
