如何通过Design允许部分组件添加至AEM Experience Fragment？

我明白你在给Facebook Experience Fragment配置/etc/design时，遇到了无法添加新组件的问题，咱们一步步来排查和修正：

• 修正Design节点的命名结构
  你当前的Design节点里，__experience-fragment-template-facebook这类带多重下划线的命名是有问题的——AEM的Design容器节点不需要前缀下划线（下划线开头是隐藏节点，模板识别不到）。正确的结构应该是：

  /etc/design/experience-fragment:
    jcr:content（已设置sling:resourceType为wcm/core/components/designer）
    experience-fragment-template-facebook
      initial
        root（已指定components属性）
  

  把节点名前的多余下划线全部去掉，让模板能正确识别到对应的Design配置。

• 确认cq:designPath的路径准确性
  检查你的Facebook Experience Fragment模板（比如/apps/your-project/templates/experience-fragment-facebook）里的cq:designPath属性，必须是绝对路径，比如/etc/design/experience-fragment/experience-fragment-template-facebook，不能用相对路径或者指向错误的节点层级。

• 校验root节点的components属性格式
  你在root节点配置的components属性，得是合法的组件资源类型数组。举个例子，如果要允许核心文本组件和自定义Facebook按钮组件，应该写成：

  ["core/wcm/components/text/v2/text", "your-project/components/custom/facebook-button"]
  

  确保每个组件路径都是正确的资源类型路径，数组的语法（引号、逗号）也不能出错。

• 重新关联并刷新缓存

  1. 保存Design节点的修改后，回到对应的Experience Fragment模板，确认cq:designPath指向的是修正后的Design节点
  2. 刷新AEM的OSGi缓存（可以通过/system/console/bundles页面刷新WCM相关bundle，或者直接重启AEM快速生效）
  3. 打开一个使用该模板的Experience Fragment实例，尝试打开组件添加面板，看看允许的组件是否正常加载

• 额外排查方向

  • 确认你的Experience Fragment模板的jcr:content/sling:resourceType是正确的体验片段资源类型，比如core/wcm/components/experiencefragment/v1/experiencefragment
  • 查看AEM的错误日志（crx-quickstart/logs/error.log），找有没有Design加载相关的报错，比如路径找不到、权限不足这类信息，能帮你快速定位问题

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