文档Experience Cloud KCS

由于核心组件数据层配置不正确，部署失败

最近更新： 2026年6月22日

当/conf下的核心组件数据层配置是使用不正确的节点类型创建时，Adobe Experience Manager as a Cloud Service的Cloud Manager部署在 安装可变内容 步骤期间失败。 配置节点创建为cq:Page，不支持所需的enabled属性，从而导致OakConstraint0004约束违规和包安装失败。

要解决此问题，请更新配置节点以使用正确的主类型，设置所需的属性，然后重新部署正确的配置包。

描述 description

环境

Adobe Experience Manager as a Cloud Service — 站点

问题/症状

  • Cloud Manager管道在部署期间失败，并出现错误“安装可变内容 — 失败”。
  • 安装cp2fm转换的配置包时，可变内容作业失败，例如：
    • /etc/packages/<group>/<site>-base-config-content-<version>-cp2fm-converted.zip
  • 管道日志显示以下错误：
    • OakConstraint0004: /conf/<site>/sling:configs/com.adobe.cq.wcm.core.components.internal.DataLayerConfig[ [ cq:Page] ] : No matching property definition found for enabled = true.
  • DataLayerConfig节点创建为cq:Page，但cq:Page未定义enabled属性，这会导致约束违规和包安装失败。

解决方法 resolution

请按照以下步骤修复问题：

  1. 更新位于/conf/<site>/sling:configs/com.adobe.cq.wcm.core.components.internal.DataLayerConfig的节点以使用jcr:primaryType=nt:unstructured。 有关更多详细信息，请参阅将Adobe客户端数据层与核心组件结合使用。
  2. 在nt:unstructured节点上将enabled=true设置为布尔属性。
  3. 确保配置节点未创建为cq:Page，并且不使用页面模板或页面结构。
  4. 验证/content/<site>/jcr:content是否包含sling:configRef=/conf/<site>，以便正确引用配置。
  5. 使用这些更正重新构建基本配置内容包。
  6. 重新部署包，并确认 安装可变内容 步骤和整个部署已成功完成。

注释：

自核心组件版本2.9.0及更高版本开始，Adobe客户端数据层作为核心组件客户端库的一部分提供。 要启用它，只需要/conf/<site>/sling:configs下的上下文感知配置。 不需要单独的数据层组件安装包。

相关阅读

recommendation-more-help
experience-cloud-kcs-help-kbarticles