排除 Experience Cloud 站点中的元数据部署错误
解决使用 ExperienceBundle 部署 LWR 和 Aura 站点或使用 DigitalExperienceBundle 部署增强 LWR 站点时可能出现的问题。
所需的 Edition
| 适用于：Salesforce Classic 和 Lightning Experience |
| 适用于：Enterprise、Performance、Unlimited 和 Developer Edition |
| 适用于：LWR 和 Aura 站点 |
| 错误消息 | 原因 | 解决方案 |
|---|---|---|
| 在此视图中为每个组件指定唯一 ID。 | 在 DigitalExperienceBundle 中，视图中的每个组件必须具有唯一 ID。在这种情况下，两个或多个组件具有相同的 ID。 | 使用 DigitalExperienceBundle 从源和目标组织检索元数据。 在导致错误的视图中，在源和目标组织中，搜索 ID 匹配的组件。 当您找到匹配的 ID 时，通过更改几个字符来手动更新它，以确保每个组件都有一个唯一的标识符。 |
| 现有路线的 devName 无法更改。将 generated_route_id 路由的 devName 恢复为原始值，然后重试。 | 在 ExperienceBundle 中，devName 代表在创建路线时自动生成的唯一 API 名称。devName 是必填值，不得更改。如果以某种方式更改了该值，则会出现此错误。 | 查看与标准组件功能相关的任何最近修改或自定义。确定更改名称的方式和原因，并将名称还原为原始值。 或者，考虑将 SiteDotCom 用于部署，而不是 ExperienceBundle。 |
| 我们无法在 file_path.json 中为组件 component_id 验证 property_name。错误：specific_error_information | 在 ExperienceBundle 中，当源组织中的站点配置与目标组织不匹配时，会出现此错误。例如，假设源组织中的主题使用 Default_User_Profile_Menu，但目标组织中的主题使用 Default_User_Profile_Menu1。 | 确保源和目标组织中的站点使用相同的配置。例如，如果特定错误消息提及缺少组件，请确保组件名称在两个组织中匹配。 |
| 您似乎缺少组件 ID 为 component_id 的 site_name/config/mainAppPage.json 中的属性 isLockerServiceEnabled。 | 在 ExperienceBundle 中，当站点的 config/mainAppPage.json 文件中的 isLockerServiceEnabled 属性缺失时，会出现此错误。 | 将"isRelaxedCSPLevel" : false添加到 config/mainAppPage.json 文件。 |
| 站点需要路线类型为 route_type 的路线。 | 由于各种原因，可能会出现此问题。 原因 1：在源组织和目标组织中启用的站点功能或自定义对象之间存在差异。 由于这一差异，ExperienceBundle 检索过程不能包括源组织中必要的对象或功能相关文件。但目标组织需要这些文件。 |
在源组织中启用相关权限。然后，再次检索 ExperienceBundle，并将更新的捆绑包部署到目标组织。 如果无法在源组织中启用该权限，您可以禁用目标组织上的权限。请记住，因此，部署站点中可能缺少权限相关功能。 |
| 原因 2：每个站点模板包含所需的默认路线类型。如果以某种方式删除或重命名了路线类型，可能会出现此问题。 | 更新 site_name.site-meta.xml 文件，以包含具有正确路线类型的路线。确保路线配置符合站点的预期功能。 |
本文章是否解决您的问题？
请与我们共享您的想法，以便我们进行改进！
