文档Experience Cloud KCS

当所需的客户端库缺失时，AEM PDF Viewer呈现空白

最近更新： 2026年6月30日

当站点客户端库配置中未包含所需的客户端库时，AEM PDF Viewer组件可以呈现为空容器。 在AEM as a Cloud Service中，如果PDF查看器CA-config使用的客户端ID与页面域不匹配，则渲染也会失败。 因此，即使页面上存在该组件，查看器仍无法在“创作”或“发布”中正确加载。 嵌入所需的PDF Viewer客户端库，验证CA-config客户端ID，并在两个环境中重新测试页面。

描述 description

环境

  • Adobe Experience Manager as a Cloud Service (AEMaaCS)
  • Adobe Experience Manager 6.5内部部署

问题/症状

  • PDF Viewer组件在页面上显示空白或空区域。
  • 无法在“创作”或“发布”中正确加载查看器。
  • 浏览器中无法加载所需的PDF查看器JavaScript或CSS文件。
  • 在AEM as a Cloud Service中，即使在页面上配置了组件，查看器也会失败。

原因

该页面缺少所需的PDF Viewer客户端库，因为core.wcm.components.pdfviewer.v1未嵌入到站点clientlib-base中。 在AEM as a Cloud Service中，如果PdfViewerCaConfig客户端ID有效但映射到与用于打开页面的域ID不同的域，则渲染也会失败。

解决方法 resolution

要解决由于缺少客户端库导致的空白AEM PDF Viewer渲染问题，请执行以下步骤：

  1. 在/apps/<project>/clientlibs/clientlib-base处打开站点客户端库。
  2. 检查embed属性并添加core.wcm.components.pdfviewer.v1（如果缺少）。
  3. 部署更新的客户端库配置。 对于AEM as a Cloud Service，请通过Cloud Manager部署更改。
  4. 对于AEMaaCS，打开/conf/<project>/sling:configs并验证PdfViewerCaConfig是否包含用于访问页面的确切域的正确clientId。
  5. 重新加载页面，并在“创作”和“发布”中测试PDF Viewer。
  6. 检查浏览器的“网络”选项卡，并确认所需的PDF Viewer JavaScript和CSS文件现在已成功加载。
  7. 如果客户端库嵌入正确且查看器仍呈现空白，请联系Adobe支持并共享页面URL、浏览器控制台日志和网络跟踪。

相关阅读

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