Umbraco V7升级至V8后Related Links后台面板消失问题求助

问题说明 #

• 升级背景：Umbraco从V7版本升级至V8版本
• 核心问题：原RelatedLinks类型的数据，升级后对应DataType自动转为Multi Url Picker，但后台面板无法显示这些存量链接；通过接口调用仍能正常获取到数据
• 场景截图说明：
  • 问题截图1：后台面板无相关链接显示的空白状态
  • 问题截图2：DataType已切换为Multi Url Picker的配置界面
  • 新建相关链接截图：新创建的Multi Url Picker链接可正常显示

解决方案 #

1. 校验Multi Url Picker的DataType配置 #

进入后台【设置】→【数据类型】，找到对应的Multi Url Picker类型，确认配置项：

• 选择**"Related Links"渲染模式**（这是匹配旧版RelatedLinks的专属渲染方式）
• 勾选与旧版一致的权限选项（如允许内部链接、允许外部链接、允许媒体链接等）

2. 批量转换数据格式 #

V7的RelatedLinks与V8的Multi Url Picker数据格式不兼容，需将存量数据字段映射转换：
旧版RelatedLinks数据格式示例：

[
  {
    "caption": "示例链接",
    "link": "/about-us",
    "newWindow": false,
    "internal": 1050,
    "edit": false
  }
]

新版Multi Url Picker要求格式：

[
  {
    "name": "示例链接",
    "url": "/about-us",
    "target": "_self",
    "udi": "umb://document/abc123def456",
    "isMedia": false
  }
]

可通过以下方式处理：

• 直接操作cmsPropertyData表，编写SQL脚本批量替换字段（操作前务必备份数据库）
• 使用Umbraco服务API，遍历节点批量转换数据格式

3. 重新触发升级数据转换 #

若升级过程中数据转换脚本未执行完全：

• 备份数据库后，将站点设置为调试模式，重启应用
• 访问站点/install路径，重新触发升级检查流程
• 查看App_Data/Logs下的日志文件，排查是否存在转换失败的报错，针对性修复

4. 重建文档类型属性 #

若以上方法无效，可尝试：

• 删除文档类型中当前的Multi Url Picker属性
• 新建一个配置正确的Multi Url Picker属性
• 通过API或后台手动将原有数据迁移至新属性中

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