XWiki导入Confluence空间后含/的异常页面标题修改方法咨询

直接修改xwikidoc表不生效的核心原因是XWiki的页面层级关联、引用关系、搜索索引、缓存数据并非仅存储在xwikidoc单表中，仅修改单表数据会因为关联数据不匹配、旧缓存未失效导致修改完全不生效。

优先推荐：使用XWiki原生Groovy脚本修复（无数据一致性风险） #

这是最稳妥的处理方式，原生API会自动处理所有关联数据更新，不会出现漏改问题：

• 使用超级管理员账号登录XWiki，创建一个仅自己可见的临时页面，将页面编辑器切换为Groovy脚本模式
• 粘贴以下基础脚本，将targetSpace变量的值替换为你从Confluence导入的目标空间标识：

// 替换为导入的目标空间名
def targetSpace = "YourImportedSpaceKey"
def xwiki = services.xwiki
def query = "from XWikiDocument doc where doc.space like :spacePrefix and (doc.title like :slashMark or doc.name like :slashMark)"
def params = [
  spacePrefix: "${targetSpace}.%",
  slashMark: "%/%"
]
def matchedDocs = xwiki.search(query, params)
matchedDocs.each { doc ->
  def originFullName = doc.fullName
  // 可根据需求调整替换规则，这里默认将/替换为-
  def fixedTitle = doc.title.replace("/", "-")
  def fixedPageName = doc.name.replace("/", "-")
  def targetFullName = "${doc.space}.${fixedPageName}"
  if (originFullName != targetFullName) {
    // 参数依次为：目标路径、新标题、保留重定向、更新子页面路径、更新站内链接、更新别名、上下文
    xwiki.getDocument(originFullName).rename(targetFullName, fixedTitle, true, true, true, true, context.context)
    println "已修复页面：${originFullName} -> ${targetFullName}"
  }
}

• 执行脚本，等待所有匹配页面修复完成后，删除这个临时脚本页面，避免误操作
• 进入XWiki后台管理的缓存页面，清空全部缓存后即可正常访问所有页面，子页面的路径关联会自动同步更新，不会再触发400错误。

若必须通过数据库直接修改，需完成以下配套操作（操作前必须全量备份数据库和XWiki数据目录） #

直接操作数据库风险极高，漏改任意关联字段都会导致页面丢失、引用失效，仅建议在服务完全无法启动、无法执行脚本的极端场景下使用：

• 第一步：完全停止XWiki服务，避免运行时内存缓存写入磁盘覆盖修改
• 第二步：修改xwikidoc表中异常页面的XWD_TITLE（显示标题）、XWD_NAME（URL路径页面名）字段后，同步更新所有关联表数据：
  • 如果异常页面是对应空间的首页，同步修改xwikispace表中对应空间的XWS_HOMEPAGE字段值为修改后的页面完整路径
  • 同步更新xwikilinks表中所有指向该异常页面的链接记录，将XWL_LINK、XWL_FULLNAME字段中包含旧页面路径的/替换为新页面名
  • 批量更新该页面下所有子页面的XWD_FULLNAME、XWD_WEB字段，将父路径部分替换为修改后的新路径，否则子页面会因为父节点路径不匹配无法访问
  • 同步更新xwikiobjects、xwikiclasses、xwikiproperties表中所有绑定在异常页面/其子页面上的对象、类、属性记录的XWO_NAME、XWO_FULLNAME关联字段，避免页面关联的对象数据丢失
• 第三步：删除XWiki数据目录下cache文件夹内的所有缓存文件，避免旧缓存加载导致修改不生效
• 第四步：启动XWiki服务，进入后台搜索索引管理页面，触发全量索引重建，修复搜索、页面引用关联的异常

注意：数据库修改完成后建议逐个抽查异常页面和对应子页面的访问、编辑、附件上传功能，确认没有关联数据丢失问题。

内容的提问来源于stack exchange，提问作者Andy Johnson